textSeptember 22, 2026•2 min read•ToolsHub Editorial Team

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.

Share guide:X / TwitterLinkedIn
Related Online Tool

Try the Markdown Preview

Calculate your numbers instantly in your browser. Fast, free, no signup.

Open Tool

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)
![Logo Alt Text](/logo.png)

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.

AN

ToolsHub Editorial Team

Verified Author

Technical 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.

Published on ToolsHub Pro • 100% Client-Side Free Tools

Recommended Tools

Related Guides