up/docs/contributing/markdown.md
Tolaria a1db08f32e
Some checks failed
Deploy Docs / deploy (push) Failing after 23s
fix: wiki links now root-relative — handles Tolaria [[docs/path/to/page]] format
Strips docs/ prefix from Tolaria-generated links, collapses /index suffixes,
removes .md extensions, and produces root-relative URLs (/page/path/) that
work from any page regardless of depth. Images get root-relative asset paths.
2026-06-03 20:38:15 +08:00

114 lines
1.6 KiB
Markdown

---
icon: simple/markdown
---
# Markdown in 5min
## Introduction to Markdown Language
Markdown is a simple language to build web pages. It is easier to read and write than HTML (the language web browsers read) and so we use it to write articles. You can use this reference to help you write posts and pages directly in our repository where the source documents for this wiki are held. See [[docs/contributing/index]] for more.
## Headers
```text
# H1 Header
## H2 Header
### H3 Header
#### H4 Header
##### H5 Header
###### H6 Header
```
## Text formatting
```text
**bold text**
*italic text*
***bold and italic***
~~strikethrough~~
`inline code`
```
## Links and images
```text
[Link text](https://example.com)
[Link with title](https://example.com "Hover title")
![Alt text](./image.jpg)
![Image with title](./image.jpg "Image title")
```
## Lists
```yaml
Unordered:
- Item 1
- Item 2
- Nested item
Ordered:
1. First item
2. Second item
3. Third item
```
## Blockquotes
```text
> This is a blockquote
> Multiple lines
>> Nested quote
```
## Code blocks
````javascript
```javascript
function hello() {
console.log("Hello, world!");
}
```
````
## Tables
```text
| Header 1 | Header 2 | Header 3 |
|----------|----------|----------|
| Row 1 | Data | Data |
| Row 2 | Data | Data |
```
## Horizontal rule
```text
---
or
***
or
___
```
## Task lists
```text
- [x] Completed task
- [ ] Incomplete task
- [ ] Another task
```
## Escaping characters
```text
Use backslash to escape: \* \_ \# \`
```
## Line breaks
```text
End a line with two spaces
to create a line break.
Or use a blank line for a new paragraph.
```