Markdown Cheat Sheet
A practical Markdown syntax cheat sheet and quick reference for GitHub, docs and AI writing. Covers GFM tables, task lists, code fences, plus Math and Mermaid used in MD Workbox.
All processing on this page runs locally in your browser unless noted otherwise.
Headings
Use one H1 per page when you can. ATX (#) style is the most portable.
| Syntax | Meaning | Example |
|---|---|---|
# Heading 1 | Top-level heading | Heading 1 |
## Heading 2 | Section heading | Heading 2 |
### Heading 3 | Subsection | Heading 3 |
#### Heading 4 | Minor heading | Heading 4 |
Emphasis
| Syntax | Meaning | Example |
|---|---|---|
**bold** | Bold | bold |
__bold__ | Bold (alternate) | bold |
*italic* | Italic | italic |
_italic_ | Italic (alternate) | italic |
***bold italic*** | Bold + italic | bold italic |
~~strike~~ | Strikethrough (GFM) |
|
Lists
| Syntax | Meaning | Example |
|---|---|---|
- item - item | Unordered list (-, * or +) |
|
1. item 2. item | Ordered list |
|
- parent - child | Nested list (indent 2 spaces) |
|
Task lists
GitHub-flavored Markdown checkboxes — useful for AI-generated action items.
| Syntax | Meaning | Example |
|---|---|---|
- [ ] todo - [x] done | Unchecked / checked tasks |
Links & images
| Syntax | Meaning | Example |
|---|---|---|
[text](https://mdworkbox.com) | Inline link | |
[text](url "title") | Link with title attribute | |
 | Image (alt text required for accessibility) |
|
<https://mdworkbox.com> | Autolink |
Code
| Syntax | Meaning | Example |
|---|---|---|
`code` | Inline code | Use |
```js code ``` | Fenced code block with language tag |
|
``` plain ``` | Fenced block without a language |
|
Quotes & rules
| Syntax | Meaning | Example |
|---|---|---|
> quoted text | Blockquote |
|
> a >> nested | Nested quote |
|
--- | Horizontal rule (***, --- or ___) | Above Below |
Tables
Header row + separator are required. Alignment uses `:---` / `---:` / `:---:`.
| Syntax | Meaning | Example | ||||||
|---|---|---|---|---|---|---|---|---|
| A | B | | --- | --- | | 1 | 2 | | Basic GFM table |
| ||||||
| L | C | R | | :--- | :---: | ---: | | Left / center / right alignment |
|
Math formulas
Supported in MD Workbox Editor and converters (MathML or KaTeX). Also accepts \( \) and \[ \].
| Syntax | Meaning | Example |
|---|---|---|
$E = mc^2$ | Inline math | Inline |
$$ \int_a^b f(x)\,dx $$ | Display math |
Mermaid diagrams
Use a ```mermaid fence. Preview, HTML, PDF, DOCX and Image export render diagrams locally.
| Syntax | Meaning | Example |
|---|---|---|
```mermaid flowchart LR A --> B ``` | Flowchart (sequence, class, state, pie, … also work) | flowchart LR A[Paste] --> B[Preview] B --> C[Export] |
Escaping
| Syntax | Meaning | Example |
|---|---|---|
\*not italic\* | Escape special characters with a backslash | *not italic* and `not code` |
How to use
- Scan the section nav or jump to Headings, Tables, Math or Mermaid.
- Click Copy on any syntax cell, then paste into the Editor or your docs.
- Use Try examples in Editor to open a sample with formulas and a Mermaid diagram.
- This Markdown reference guide follows common GFM rules used on GitHub and in most static site generators.
FAQ
Is this Markdown flavor GitHub-compatible?
Yes for the everyday syntax listed here (tables, task lists, strikethrough, fenced code). MD Workbox also adds Math delimiters and mermaid fences used by its preview and export tools.
Markdown cheat sheet vs full spec?
This page is a quick reference for writers and developers — not the CommonMark specification. Prefer the patterns above for maximum portability across GitHub, Notion exports and AI chat output.
How do I fix broken Markdown from ChatGPT?
Paste it into Clean Markdown to normalize fences and spacing, then preview in the Editor.
Does this page upload anything?
No. Copying syntax and rendering examples run in your browser. Opening the Editor only keeps a local draft.