Markdown cheatsheet

Every bit of Markdown the Mezaic editor supports, including code blocks with titles, callouts, embeds, footnotes and tables.

Blog posts, journey introductions and entries, company descriptions and announcements are written in Markdown. Mezaic uses standard CommonMark with GitHub extensions plus a few additions of its own.

Text

markdown
**bold**   *italic*   ~~strikethrough~~   `inline code`

Straight quotes and ... are turned into typographic quotes and an ellipsis automatically.

Headings

markdown
## Section heading
### Sub-heading

Use ## for top-level sections; the post title is already the h1. Posts with three or more ## headings get an automatic table of contents. Each heading gets an anchor you can link to (#section-heading).

markdown
[Link text](https://example.com)
![Alt text](https://yourname.com/media/photo.jpg "Optional caption")

An image on its own line becomes a figure; the title (or, failing that, the alt text) is the caption. Paste or drop an image into the editor to upload it and insert this for you.

Lists

markdown
- item
- item
  - nested

1. first
2. second

- [x] done
- [ ] to do

Quotes and callouts

markdown
> A plain quote.

> [!NOTE]
> Something worth knowing.

Callout kinds: [!NOTE], [!TIP], [!IMPORTANT], [!WARNING], [!CAUTION]. They render as coloured boxes with a label.

Code

Fenced blocks are highlighted on the server. Name the language after the opening fence, and add a title to show a filename:

markdown
```go title=main.go
fmt.Println("hello")
```

Every code block on your site has a Copy button. Over a hundred languages are recognised; without a language Mezaic guesses.

Embeds

Put a link on its own line to embed it as a click-to-load player:

markdown
https://www.youtube.com/watch?v=dQw4w9WgXcQ

Supported: YouTube, Vimeo, Spotify, SoundCloud, CodePen and X. Nothing is fetched from the provider until the reader clicks.

Tables

markdown
| Plan | Links |
|------|------:|
| Free | 25    |
| Pro  | 500   |

Colons in the separator row set alignment.

Footnotes

markdown
Something surprising.[^1]

[^1]: With a source.

Horizontal rule

markdown
---

HTML

Raw HTML is removed for safety. Use the Markdown equivalents above, or Custom code for site-wide scripts.