Complete Markdown Syntax Guide: Formatting Text for the Web & GitHub
Master Markdown formatting for web publishing and technical documentation. A complete guide to headings, code blocks, tables, blockquotes, and CommonMark standards.
Try the Markdown Preview
Calculate your numbers instantly in your browser. Fast, free, no signup.
Created in 2004 by John Gruber and Aaron Swartz, Markdown was designed with a clear, elegant mission: to allow writers and developers to create rich text using an easy-to-read, easy-to-write plain text format that converts cleanly into semantically valid XHTML/HTML.
Today, Markdown is the undisputed standard for technical documentation, GitHub READMEs, static site generators (Next.js, Astro), chat applications (Slack, Discord), and modern CMS workflows.
1. Headings
Headings are created using the hash (#) symbol, matching HTML <h1> through <h6>:
# Heading 1 (Page Title)
## Heading 2 (Major Section)
### Heading 3 (Subsection)
#### Heading 4
##### Heading 5
###### Heading 6
2. Text Formatting & Emphasis
| Style | Syntax | Result |
|---|---|---|
| Bold | **bold text** | bold text |
| Italic | *italic text* | italic text |
| Bold & Italic | ***bold and italic*** | bold and italic |
| ~~Strikethrough~~ | ~~strikethrough~~ | ~~strikethrough~~ |
| Inline Code | `const x = 10;` | const x = 10; |
3. Lists: Ordered & Unordered
Unordered Lists (Bullets)
Use asterisks (*), hyphens (-), or plus signs (+):
- First bullet item
- Second bullet item
- Nested sub-bullet (indented with 2 or 4 spaces)
Ordered Lists (Numbers)
1. First step
2. Second step
3. Third step
4. Code Blocks with Syntax Highlighting
Fenced code blocks are demarcated by three backticks (```) with an optional language identifier for syntax highlighting:
```typescript
interface UserSession {
id: string;
email: string;
isActive: boolean;
}
```
5. Links and Images
[ToolsHub Pro](https://www.aiwithab.site)

6. Blockquotes
Blockquotes are formatted with the greater-than symbol (>):
> "Simplicity is prerequisite for reliability."
> — Edsger W. Dijkstra
7. GitHub Flavored Markdown (GFM) Tables
| Header 1 | Header 2 | Header 3 |
|:---|:---:|---:|
| Left-aligned | Centered | Right-aligned |
| Row 1 Value | Central Value | $19.99 |
Preview & Write Markdown Live
Tired of rendering errors or broken tables? Use our split-pane Markdown Preview Tool to write, edit, and see your rendered HTML in real time with side-by-side editing.
ToolsHub Editorial Team
Verified AuthorTechnical Architect & Lead Developer • ToolsHub Pro
Abdul Nabi is a senior software engineer and technical architect specializing in client-side Web APIs, high-performance browser computing, cryptographic validation, and privacy-first digital utility platforms. All guides on ToolsHub Pro are peer-reviewed for mathematical rigor and developer accuracy.