简体中文
EnglishBasic vs. Extended Markdown Syntax on Markdown Guide
Updated
Markdown Guide splits its syntax reference into two sections: Basic Syntax covers the core formatting elements that work almost everywhere, while Extended Syntax covers features like tables, fenced code blocks, and automatic links that many — but not all — Markdown processors support. If you only need headings, emphasis, lists, links, and images, Basic Syntax is enough. If you need tables, code blocks with language labels, footnotes, or definition lists, you'll need to check Extended Syntax and confirm your target platform supports it.
What Basic Syntax covers
The Basic Syntax section is the starting point for anyone learning Markdown, and the site describes it as useful for both newcomers and experienced users who need answers to formatting questions. It covers the elements defined in the original Markdown specification — the syntax that has the widest compatibility across editors, note apps, and publishing platforms.
Typical Basic Syntax elements include:
- Headings (
#through######) - Paragraphs and line breaks
- Bold and italic emphasis
- Blockquotes
- Ordered and unordered lists
- Inline code
- Links and images
- Horizontal rules
The practical advantage of Basic Syntax is portability. Because these elements come from the original Markdown design, they render correctly in the widest range of tools. If you're writing something you may need to move between platforms, staying within Basic Syntax reduces the risk of broken formatting.
What Extended Syntax adds
Markdown Guide presents Extended Syntax as a way to "take it up a notch" — creating tables, fenced code blocks, automatic links, and more. These features were not part of the original Markdown specification. They were introduced by other lightweight markup languages and individual Markdown processors, then gradually adopted across the ecosystem.
Common Extended Syntax elements include:
- Tables
- Fenced code blocks (with optional language identifiers for syntax highlighting)
- Footnotes
- Definition lists
- Strikethrough
- Task lists
- Automatic URL linking
- Heading IDs and custom attributes
The key difference is not difficulty — it's support. Extended Syntax features depend on which Markdown processor or platform you're using. A table that renders on GitHub may not render in a plain-text editor or an older CMS.
How to decide which one to learn
| Your situation | Start with |
|---|---|
| New to Markdown, writing notes or simple documents | Basic Syntax |
| Writing for one known platform (GitHub, Obsidian, a static site generator) | Basic Syntax, then check that platform's Extended Syntax support |
| Need tables, footnotes, or syntax-highlighted code | Extended Syntax |
| Moving documents between multiple tools | Basic Syntax first; add Extended Syntax only where verified |
| Building documentation or technical content | Both, with attention to processor compatibility |
A practical approach: learn Basic Syntax until it feels automatic, then add Extended Syntax features one at a time as your writing actually requires them. Before relying on any Extended Syntax element, check the documentation of the tool you're publishing to.
Where to go on Markdown Guide
The site's own structure maps to this split:
- Getting Started — for people who want to begin using Markdown immediately, described as designed for everyone, even novices.
- Basic Syntax — the reference for core formatting questions.
- Extended Syntax — the reference for tables, fenced code blocks, automatic links, and similar additions.
Markdown Guide is a free and open-source reference guide, licensed CC BY-SA 4.0, so you can read and reuse the material under that license. Start with Basic Syntax if you're new; move to Extended Syntax when a specific formatting need — a table, a footnote, a labeled code block — actually comes up.