MDConverter
Universal In-Browser Converter
100% Client-Side Private
Complete 2026 Reference Manual

Universal Markdown Cheat Sheet

The ultimate, exhaustive guide to GitHub Flavored Markdown (GFM), CommonMark, Mathematical LaTeX, Mermaid Diagrams, Alert Admonitions, and Extended Syntax.

Open Converter StudioPlatform Flavor Matrix
Showing 26 syntax references

ATX Headings (H1 to H6)

Headings & Text
Markdown Syntax
# Heading 1 (Document Title)
## Heading 2 (Major Section)
### Heading 3 (Subsection)
#### Heading 4
##### Heading 5
###### Heading 6
Behavior & Rendering

Six levels of hierarchical headings. Modern parsers auto-generate anchor IDs for easy linking.

Always include a space between the # and heading text.

Setext Headings (H1 & H2 Underlines)

Headings & Text
Markdown Syntax
Heading 1 Title
===============

Heading 2 Section
-----------------
Behavior & Rendering

Alternative heading style using 3 or more = or - characters.

Bold, Italic & Strikethrough

Headings & Text
Markdown Syntax
**Bold text** or __Bold text__
*Italic text* or _Italic text_
***Bold and italic*** or ___Bold and italic___
~~Strikethrough text~~
==Highlighted mark==
Behavior & Rendering

Primary text emphasis styles. Double asterisks for bold, single for italic, tildes for strikethrough.

Subscript & Superscript

Headings & Text
Markdown Syntax
Water formula: H~2~O
Exponential math: X^2^ + Y^2^ = Z^2^
Behavior & Rendering

Subscript is wrapped in single tildes (~), superscript in carets (^).

Line Breaks & Horizontal Rules

Headings & Text
Markdown Syntax
First line with two trailing spaces  
Second line directly below

---
***
___
Behavior & Rendering

Two trailing spaces or <br/> creates a line break. Three or more hyphens create a divider rule.

Unordered Bullet Lists

Lists & Tasks
Markdown Syntax
- 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 plus
Behavior & Rendering

Bulleted lists indented with 2 or 4 spaces for nested hierarchies.

Ordered Numbered Lists

Lists & Tasks
Markdown Syntax
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)
Behavior & Rendering

Numbered lists automatically re-number themselves sequentially.

Interactive GFM Task Lists (Checkboxes)

Lists & Tasks
Markdown Syntax
- [x] Completed milestone or deliverable
- [x] Verified unit tests & benchmarks
- [ ] Pending code review approval
- [ ] Deploy to production cluster
Behavior & Rendering

Renders clickable or disabled HTML checkboxes for sprint tasks and checklists.

Definition Lists

Lists & Tasks
Markdown Syntax
Markdown
: A lightweight markup language with plain text formatting syntax.

GFM
: GitHub Flavored Markdown specification adding tables, task lists, and strikethrough.
Behavior & Rendering

Defines terms and explanatory definitions.

Column Alignment (Left, Center, Right)

Tables
Markdown Syntax
| Feature | Alignment | Priority | Status |
| :--- | :---: | ---: | :--- |
| Table Headers | Left | 1 | Active |
| Centered Numbers | Center | 250 | In Review |
| Currency / Right | Right | $1,299.00 | Complete |
Behavior & Rendering

Colon position on the delimiter row controls alignment (:--- left, :---: center, ---: right).

Formatting Inside Table Cells

Tables
Markdown Syntax
| 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 |
Behavior & Rendering

Supports inline bold, code, links, <br/> breaks, and escaped pipe characters (\|).

Fenced Code Blocks with Language Tags

Code & Syntax
Markdown Syntax
```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,
};
```
Behavior & Rendering

Enables rich syntax highlighting for 30+ languages (js, ts, python, rust, go, bash, sql, json, yaml, etc.).

Diff Code Blocks (Added / Deleted)

Code & Syntax
Markdown Syntax
```diff
- const legacyServer = "http://api.old.com";
+ const modernEngine = "https://mdconverter.net/api";
  const timeoutMs = 5000;
```
Behavior & Rendering

Highlights green additions (+) and red removals (-) in documentation and pull requests.

Inline Code & Escaping Backticks

Code & Syntax
Markdown Syntax
Use the `npm run build` command to compile.
To show backticks inside code: ``` `code with backticks` ```
Behavior & Rendering

Use single backticks for inline code, or double backticks to enclose literal backtick characters.

GitHub Alert Callout Admonitions

Alerts & Callouts
Markdown Syntax
> [!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.
Behavior & Rendering

Renders styled, color-coded callout alert boxes in GitHub, Obsidian, and modern Markdown platforms.

Nested & Multi-paragraph Blockquotes

Alerts & Callouts
Markdown Syntax
> "Simplicity is prerequisite for reliability."
>
> — Edsger W. Dijkstra
>> Nested level 2 quotation
>>> Deeply nested citation
Behavior & Rendering

Multi-level indented quote blocks for citations and dialogue.

Hyperlinks (Inline, Tooltip & Reference)

Links & Media
Markdown Syntax
[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"
Behavior & Rendering

Complete link formats including anchor jumps and reusable reference definitions.

Images, Badges & Clickable Image Links

Links & Media
Markdown Syntax
![Alt Text Description](https://images.unsplash.com/photo-1555066931-4365d14bab8c?w=800 "Optional Title")

[![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg)](https://mdconverter.net)

<img src="https://example.com/logo.png" width="120" alt="Logo with custom width" />
Behavior & Rendering

Standard image embeddings, shield badges, and clickable image banners.

Footnotes & Bibliographic Citations

Links & Media
Markdown Syntax
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).
Behavior & Rendering

Numbered footnote citations with clickable back-references at the document bottom.

Inline Mathematical Expressions

Math (LaTeX)
Markdown Syntax
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}$
Behavior & Rendering

Renders KaTeX / MathJax typography inline using single dollar signs ($).

Block Mathematical Equations & Matrices

Math (LaTeX)
Markdown Syntax
$$
\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}
$$
Behavior & Rendering

Renders centered display formulas, integrals, and matrices using double dollar signs ($$).

Flowcharts & Architecture Diagrams

Mermaid Diagrams
Markdown Syntax
```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
```
Behavior & Rendering

Renders dynamic flowcharts, trees, and decision graphs natively inside Markdown.

Sequence & Interaction Diagrams

Mermaid Diagrams
Markdown Syntax
```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)
```
Behavior & Rendering

Renders interactive sequence diagrams for API flows and protocol interactions.

Collapsible Accordion Details

HTML Tags
Markdown Syntax
<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>
Behavior & Rendering

Interactive dropdown drawer accordion for FAQs and long logs.

Keyboard Keys, Mark & Abbreviations

HTML Tags
Markdown Syntax
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>
Behavior & Rendering

Stylized physical keyboard button tags (<kbd>), highlight marks, and hover abbreviations.

YAML Frontmatter (Jekyll / Next.js / Astro)

Frontmatter
Markdown Syntax
---
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.
Behavior & Rendering

Standard metadata headers used by static site generators, CMS platforms, and documentation hubs.

Specification Matrix

Markdown Flavor Compatibility Comparison

Different platforms support different subsets of Markdown syntax. Here is how major flavors compare:

Syntax FeatureGitHub (GFM)CommonMarkObsidian / NotionSlack mrkdwnJira MarkupDiscord
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