Markdown Syntax

MinimalDoc supports standard Markdown plus GitHub Flavored Markdown (GFM) extensions.

Headings

# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6

Headings generate anchor IDs automatically:

  • ## Getting Started#getting-started
  • ### API Reference#api-reference

Text Formatting

**Bold text**
*Italic text*
***Bold and italic***
~~Strikethrough~~
`Inline code`

Bold text, Italic text, Bold and italic, Strikethrough, Inline code

[Internal link](../guides/deployment.md)
[Anchor link](#headings)
[External link](https://example.com)

External links automatically open in new tabs with target="_blank".

Images

![Alt text](/images/screenshot.png)
![Alt text](/images/photo.jpg "Optional title")

Lists

Unordered

- Item one
- Item two
  - Nested item
  - Another nested
- Item three
  • Item one
  • Item two
    • Nested item
    • Another nested
  • Item three

Ordered

1. First item
2. Second item
   1. Nested first
   2. Nested second
3. Third item
  1. First item
  2. Second item
    1. Nested first
    2. Nested second
  3. Third item

Task Lists

- [x] Completed task
- [ ] Incomplete task
- [ ] Another task
  • Completed task
  • Incomplete task
  • Another task

Blockquotes

> Single line quote

> Multi-line quote
> continues here
>
> > Nested quote

Single line quote

Multi-line quote
continues here

Nested quote

Code

Inline

Use `config.yaml` for configuration.

Use config.yaml for configuration.

Blocks

```go
package main

func main() {
    fmt.Println("Hello")
}
```
package main

func main() {
    fmt.Println("Hello")
}

Supported languages include: go, javascript, typescript, python, bash, yaml, json, html, css, sql, rust, swift, and 100+ more via Chroma.

Tables

| Header 1 | Header 2 | Header 3 |
|----------|:--------:|---------:|
| Left     | Center   | Right    |
| Data     | Data     | Data     |
Header 1 Header 2 Header 3
Left Center Right
Data Data Data

Column alignment:

  • :--- Left (default)
  • :---: Center
  • ---: Right

Horizontal Rule

---

HTML

Raw HTML is supported:

<details>
<summary>Click to expand</summary>

Hidden content here.

</details>
Click to expand

Hidden content here.

Escaping

Use backslash to escape special characters:

\*not italic\*
\# not a heading
\[not a link\]

*not italic*, # not a heading, [not a link]

Line Breaks

Two trailing spaces create a line break:

Line one
Line two

Or use <br>:

Line one<br>Line two