The Complete Markdown Cheat Sheet: Every Syntax Element Explained

Whether you are writing documentation, README files, blog posts, or notes, Markdown is the universal formatting language you need to know. It is lightweight, readable in plain text, and supported virtually everywhere.

This complete Markdown cheat sheet walks you through every syntax element with clear examples. Bookmark this page and refer back whenever you need a quick refresher.

Why Learn Markdown?

Portability — Markdown files work on any platform and any text editor
Speed — Format text without lifting your hands from the keyboard
Version control friendly — Plain text diffs cleanly in Git
Universal support — GitHub, Notion, Obsidian, Slack, Discord, Reddit, and thousands more
Future-proof — Your .md files will be readable decades from now

If you are already brainstorming ideas for a project, knowing Markdown lets you capture and structure those ideas fast.

Basic Syntax

Headings

Use the hash symbol (#) followed by a space. The number of hashes determines the level.

Heading 1
Heading 2
Heading 3
Heading 4

Best practice: Always put a space after the hash symbols. Use only one H1 per document.

Paragraphs and Line Breaks

Paragraphs are separated by a blank line. For a line break within a paragraph, end a line with two spaces before pressing Enter.

Bold and Italic

Bold: Wrap text in double asterisks — bold text
Italic: Wrap text in single asterisks — italic text
Bold and italic: Triple asterisks — both

Blockquotes

Prefix a line with > to create a blockquote. You can nest them with >>.

Horizontal Rules

Three or more hyphens (---), asterisks (***), or underscores (___) on their own line.

Lists

Unordered Lists

Use a hyphen (-), asterisk (*), or plus sign (+) followed by a space. Indent for nested items.

Ordered Lists

Use a number followed by a period. The actual numbers don't matter — Markdown auto-numbers them.

Mixed and Nested Lists

Combine ordered and unordered lists by indenting with 2-4 spaces.

Links and Images

Inline Links

Square brackets for text, parentheses for URL: Visit Brainotes

Reference-Style Links

Define URLs separately for cleaner documents with many links.

Images

Same as links but with an exclamation mark prefix: Alt text

Accessibility tip: Always write meaningful alt text.

Code

Inline Code

Wrap text in single backticks for inline code.

Fenced Code Blocks

Use triple backticks on their own lines. Add a language identifier for syntax highlighting (e.g., javascript, python, typescript, html, css, json, bash).

Tables

Use pipes (|) to separate columns and hyphens (-) for the header row separator.

Column Alignment

:--- aligns left (default)
:---: centers the column
---: aligns right

GitHub Flavored Markdown (GFM)

Task Lists (Checkboxes)

Create checklists with - [ ] and - [x]. On GitHub, these render as clickable checkboxes.

Strikethrough

Wrap text in double tildes: ~~struck through~~

Footnotes

Add supplementary information with [^1] syntax and [^1]: reference at the bottom.

Emoji Shortcodes

Many platforms support :rocket: :thumbsup: :white_check_mark: and similar shortcodes.

Advanced Syntax

Escaping Characters

Use a backslash to display literal characters that Markdown would otherwise interpret.

HTML in Markdown

Markdown supports inline HTML for elements it doesn't natively handle, like details/summary tags and kbd elements.

Platform-Specific Tips

| Platform | Notable Extensions | |----------|-------------------| | GitHub | Task lists, autolinked references, Mermaid diagrams | | Obsidian | Wikilinks, callouts, embedded notes | | Notion | Toggle blocks, database references | | Slack | Uses single * for bold (non-standard) | | Reddit | Superscript with ^, spoiler tags |

Markdown Writing Tips

Use blank lines generously — separate every block-level element
Keep lines under 80-100 characters — cleaner diffs in version control
Use reference links for long documents — keeps paragraphs clean
Structure with headings first — build your outline as a heading hierarchy
Preview as you write — use a live preview editor
Be consistent — pick one convention and stick with it

Markdown for Idea Capture

Markdown is one of the fastest ways to capture and organize ideas. When you're figuring out your next startup idea, a simple Markdown file can serve as your brainstorming canvas — capturing ideas, tracking progress, comparing options in tables, and outlining next steps, all in plain text.

Quick Reference Table

| Element | Syntax | |---------|--------| | Heading | # H1 through ###### H6 | | Bold | text | | Italic | text | | Blockquote | > text | | Ordered List | 1. item | | Unordered List | - item | | Link | text | | Image | alt | | Horizontal Rule | --- | | Task List | - [x] done / - [ ] todo | | Strikethrough | ~~text~~ |

Try It Yourself

Reading about Markdown is useful, but practicing it is how you actually learn. Open our free Markdown editor and start experimenting:

Launch the Live Markdown Editor →

The editor gives you a split-pane view — write raw Markdown on the left, see the rendered output on the right. No sign-up required.

Wrapping Up

Markdown is one of those skills that takes an hour to learn and saves you thousands of hours over a career. Bookmark this cheat sheet for quick reference, and when you want hands-on practice, open the live Markdown editor.

The best way to learn Markdown is to start using it for everything.