Markdown Syntax Reference

SoloMD supports CommonMark + GFM + a few common extensions. This page is a quick reference for what works.

Headings

# H1
## H2
### H3
#### H4

Emphasis

*italic* or _italic_
**bold** or __bold__
***bold italic***
~~strikethrough~~
`inline code`

Lists

- Unordered item
- Another
  - Nested

1. Ordered
2. Items

- [x] Completed task
- [ ] Pending task

Links and images

[Link text](https://example.com)
[Link with title](https://example.com "Tooltip")

![Alt text](path/to/image.png)
![Alt](./_assets/screenshot.png "Caption")

Blockquotes

> Single-line quote.
>
> Multi-paragraph quote continues.
>
> > Nested quote.

Code blocks

```python
def hello():
    print("world")
```

Supported syntax highlighting: Python, JavaScript, TypeScript, Rust, Go, Java, C, C++, HTML, CSS, JSON, YAML, SQL, XML, Bash, and more via highlight.js.

Tables

| Left | Center | Right |
| :--- | :----: | ----: |
| a    | b      | c     |
| d    | e      | f     |

Horizontal rule

---

Math (KaTeX)

Inline: $a^2 + b^2 = c^2$

Block:

$$
\int_0^\infty e^{-x^2} \, dx = \frac{\sqrt\pi}{2}
$$

Mermaid diagrams

```mermaid
graph TD
  A[Start] --> B{Decision}
  B -->|Yes| C[Done]
  B -->|No|  D[Retry]
```

Also supports sequence, class, state, ER, flowchart, gantt, pie, and more Mermaid diagram types.

Front-matter

SoloMD recognizes YAML front-matter at the top of a file (it's hidden from the rendered preview):

---
title: My Article
date: 2026-04-24
tags: [markdown, notes]
---

# Content starts here

Not supported (yet)

• Obsidian-style [[wikilinks]], callouts (> [!note]), and embedded queries — render as plain text.
• Typora-style ==highlight==, ^superscript^, ~subscript~ — not parsed.
• HTML inside markdown works but is sanitized for security when exporting.