69119f347d
Some checks failed
Deploy Docs / deploy (push) Failing after 24s
- New package _extensions/wikilinks.py: preprocessor that converts [[Page Name]], [[Page|Text]], [[Page#anchor|Text]], and ![[img]] to standard Markdown links before parsing - Skips wiki links inside fenced/inline code blocks - Slugifies targets: lowercase, spaces→hyphens - Registered as markdown extension in zensical.toml - Updated CI workflow to pip install -e . for the _extensions package - First usage: [[docs/contributing/index]] in markdown.md
114 lines
1.6 KiB
Markdown
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")
|
|
|
|
|
|
```
|
|
|
|
## 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.
|
|
```
|