Universal Markdown Cheat Sheet
The ultimate, exhaustive guide to GitHub Flavored Markdown (GFM), CommonMark, Mathematical LaTeX, Mermaid Diagrams, Alert Admonitions, and Extended Syntax.
ATX Headings (H1 to H6)
# Heading 1 (Document Title)
## Heading 2 (Major Section)
### Heading 3 (Subsection)
#### Heading 4
##### Heading 5
###### Heading 6Six levels of hierarchical headings. Modern parsers auto-generate anchor IDs for easy linking.
Setext Headings (H1 & H2 Underlines)
Heading 1 Title
===============
Heading 2 Section
-----------------Alternative heading style using 3 or more = or - characters.
Bold, Italic & Strikethrough
**Bold text** or __Bold text__
*Italic text* or _Italic text_
***Bold and italic*** or ___Bold and italic___
~~Strikethrough text~~
==Highlighted mark==Primary text emphasis styles. Double asterisks for bold, single for italic, tildes for strikethrough.
Subscript & Superscript
Water formula: H~2~O
Exponential math: X^2^ + Y^2^ = Z^2^Subscript is wrapped in single tildes (~), superscript in carets (^).
Line Breaks & Horizontal Rules
First line with two trailing spaces
Second line directly below
---
***
___Two trailing spaces or <br/> creates a line break. Three or more hyphens create a divider rule.
Unordered Bullet Lists
- Top-level item alpha
- Top-level item beta
- Sub-item nested with 2 spaces
- Sub-item 2
- Deeply nested level 3
* Alternative bullet with asterisk
+ Alternative bullet with plusBulleted lists indented with 2 or 4 spaces for nested hierarchies.
Ordered Numbered Lists
1. First sequential step
2. Second sequential step
3. Third sequential step
1. Sub-step A (indented 3 spaces)
2. Sub-step B
5. Non-sequential (renders as step 4 automatically)Numbered lists automatically re-number themselves sequentially.
Interactive GFM Task Lists (Checkboxes)
- [x] Completed milestone or deliverable
- [x] Verified unit tests & benchmarks
- [ ] Pending code review approval
- [ ] Deploy to production clusterRenders clickable or disabled HTML checkboxes for sprint tasks and checklists.
Definition Lists
Markdown
: A lightweight markup language with plain text formatting syntax.
GFM
: GitHub Flavored Markdown specification adding tables, task lists, and strikethrough.Defines terms and explanatory definitions.
Column Alignment (Left, Center, Right)
| Feature | Alignment | Priority | Status |
| :--- | :---: | ---: | :--- |
| Table Headers | Left | 1 | Active |
| Centered Numbers | Center | 250 | In Review |
| Currency / Right | Right | $1,299.00 | Complete |Colon position on the delimiter row controls alignment (:--- left, :---: center, ---: right).
Formatting Inside Table Cells
| Package | Version | Notes |
| :--- | :--- | :--- |
| **Turbopack** | `v15.0` | [Release Docs](https://nextjs.org) |
| *Tailwind* | `v4.0` | Line break with <br/> tag |
| `mdconverter` | **v2.5** | Escaped pipe: \| character |Supports inline bold, code, links, <br/> breaks, and escaped pipe characters (\|).
Fenced Code Blocks with Language Tags
```typescript
interface UserProfile {
id: string;
name: string;
role: 'admin' | 'developer';
active: boolean;
}
export const adminUser: UserProfile = {
id: 'usr_101',
name: 'Alex Vance',
role: 'admin',
active: true,
};
```Enables rich syntax highlighting for 30+ languages (js, ts, python, rust, go, bash, sql, json, yaml, etc.).
Diff Code Blocks (Added / Deleted)
```diff
- const legacyServer = "http://api.old.com";
+ const modernEngine = "https://mdconverter.net/api";
const timeoutMs = 5000;
```Highlights green additions (+) and red removals (-) in documentation and pull requests.
Inline Code & Escaping Backticks
Use the `npm run build` command to compile.
To show backticks inside code: ``` `code with backticks` ```Use single backticks for inline code, or double backticks to enclose literal backtick characters.
GitHub Alert Callout Admonitions
> [!NOTE]
> Highlights essential background information or contextual details.
> [!TIP]
> Helpful advice or best practices to optimize performance.
> [!IMPORTANT]
> Crucial information required for users to succeed.
> [!WARNING]
> Critical actions requiring attention to avoid errors or breaking changes.
> [!CAUTION]
> High-risk alerts regarding potential data loss or security issues.Renders styled, color-coded callout alert boxes in GitHub, Obsidian, and modern Markdown platforms.
Nested & Multi-paragraph Blockquotes
> "Simplicity is prerequisite for reliability."
>
> — Edsger W. Dijkstra
>> Nested level 2 quotation
>>> Deeply nested citationMulti-level indented quote blocks for citations and dialogue.
Hyperlinks (Inline, Tooltip & Reference)
[Standard Link](https://mdconverter.net)
[Link with Hover Title](https://mdconverter.net "Universal Converter")
[Internal Anchor Jump](#tables)
<https://mdconverter.net> (Autolink)
<contact@mdconverter.net> (Email autolink)
Reference link: [Official Website][site-ref]
[site-ref]: https://mdconverter.net "Reference Definition"Complete link formats including anchor jumps and reusable reference definitions.
Images, Badges & Clickable Image Links

[](https://mdconverter.net)
<img src="https://example.com/logo.png" width="120" alt="Logo with custom width" />Standard image embeddings, shield badges, and clickable image banners.
Footnotes & Bibliographic Citations
Modern browsers execute WebAssembly with near-native speed.[^1]
Client-side processing guarantees zero cloud leaks.[^privacy]
[^1]: WebAssembly Core Specification 2.0 (W3C).
[^privacy]: MDConverter Privacy Guarantee (2026).Numbered footnote citations with clickable back-references at the document bottom.
Inline Mathematical Expressions
The mass-energy equivalence formula is $E = mc^2$.
Euler's identity: $e^{i\pi} + 1 = 0$.
Standard deviation: $\sigma = \sqrt{\frac{1}{N} \sum_{i=1}^{N} (x_i - \mu)^2}$Renders KaTeX / MathJax typography inline using single dollar signs ($).
Block Mathematical Equations & Matrices
$$
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
$$
$$
\begin{pmatrix}
a & b \\
c & d
\end{pmatrix}
\begin{pmatrix}
x \\
y
\end{pmatrix}
=
\begin{pmatrix}
ax + by \\
cx + dy
\end{pmatrix}
$$Renders centered display formulas, integrals, and matrices using double dollar signs ($$).
Flowcharts & Architecture Diagrams
```mermaid
graph TD
A[Markdown Input] --> B{AST Parser}
B -->|DOCX| C[OpenXML Builder]
B -->|PDF| D[Vector Print Engine]
B -->|HTML| E[Syntax Highlighted DOM]
C --> F[100% Client-Side Download]
D --> F
E --> F
```Renders dynamic flowcharts, trees, and decision graphs natively inside Markdown.
Sequence & Interaction Diagrams
```mermaid
sequenceDiagram
autonumber
actor User
participant Browser as Client Browser
participant Worker as Web Worker Engine
User->>Browser: Drops .docx / .md file
Browser->>Worker: Parse in-memory ArrayBuffer
Worker-->>Browser: Return GFM Markdown AST
Browser-->>User: Display converted document (15ms)
```Renders interactive sequence diagrams for API flows and protocol interactions.
Collapsible Accordion Details
<details>
<summary><strong>Click to view Technical Implementation Details</strong></summary>
This content is hidden by default and expands on click:
- Sub-process 1: Lexical tokenization
- Sub-process 2: AST transformation
- Sub-process 3: Output serialization
</details>Interactive dropdown drawer accordion for FAQs and long logs.
Keyboard Keys, Mark & Abbreviations
Press <kbd>Ctrl</kbd> + <kbd>K</kbd> to open Command Palette.
Press <kbd>⌘</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> on macOS.
Important text: <mark>Highlight with mark tag</mark>.
Organization: <abbr title="World Wide Web Consortium">W3C</abbr>Stylized physical keyboard button tags (<kbd>), highlight marks, and hover abbreviations.
YAML Frontmatter (Jekyll / Next.js / Astro)
---
title: "Enterprise Document Specification"
slug: "enterprise-doc-spec"
version: 3.2.0
author: "MDConverter Team"
isPublished: true
tags:
- markdown
- documentation
- security
---
# Document Body Begins Here
The frontmatter metadata above is parsed cleanly into structured JSON.Standard metadata headers used by static site generators, CMS platforms, and documentation hubs.
Markdown Flavor Compatibility Comparison
Different platforms support different subsets of Markdown syntax. Here is how major flavors compare:
| Syntax Feature | GitHub (GFM) | CommonMark | Obsidian / Notion | Slack mrkdwn | Jira Markup | Discord |
|---|---|---|---|---|---|---|
| Basic Headings (#) | ✅ H1-H6 | ✅ H1-H6 | ✅ H1-H6 | ⚠️ *Bold* | ⚠️ h1.-h6. | ✅ H1-H3 |
| Bold Emphasis | ✅ **bold** | ✅ **bold** | ✅ **bold** | ⚠️ *bold* | ⚠️ *bold* | ✅ **bold** |
| GFM Tables | ✅ Full | ❌ No | ✅ Full | ❌ No | ⚠️ || Header || | ❌ No |
| Task Checklists | ✅ - [x] | ❌ No | ✅ Interactive | ❌ No | ❌ No | ❌ No |
| Code Highlighting | ✅ ```lang | ✅ ```lang | ✅ ```lang | ⚠️ ```block | ⚠️ {code:lang} | ✅ ```lang |
| Alert Callouts | ✅ [!NOTE] | ❌ No | ✅ > [!NOTE] | ❌ No | ⚠️ {quote} | ❌ No |
| LaTeX Math ($) | ✅ KaTeX | ❌ No | ✅ MathJax | ❌ No | ❌ No | ❌ No |
| Mermaid Diagrams | ✅ Native | ❌ No | ✅ Native | ❌ No | ❌ No | ❌ No |
| Strikethrough | ✅ ~~text~~ | ❌ No | ✅ ~~text~~ | ⚠️ ~text~ | ⚠️ -text- | ✅ ~~text~~ |
Ready to Test Your Markdown?
Launch the MDConverter Studio to edit, auto-align tables, render math, and export to PDF, Word DOCX, or HTML with 100% in-browser privacy.
Launch Interactive Studio