Markdown — Complete Guide

What Is Markdown?

Markdown is a lightweight markup language with plain-text formatting syntax designed for easy reading and writing.

Headings and Structure — Complete Guide

Markdown headings use # symbols to create a hierarchical document structure with six levels of headings.

Paragraphs and Line Breaks — Complete Guide

Markdown paragraphs are separated by blank lines, with line breaks inserted by ending a line with two spaces.

Italic, Bold, and Strikethrough — Complete Guide

Markdown emphasis uses single asterisks for italic, double asterisks for bold, and double tildes for strikethrough.

Ordered and Unordered Lists — Complete Guide

Markdown lists use asterisks or dashes for unordered and numbers for ordered lists, with sublists created by indentation.

Links and URLs — Complete Guide

Markdown links use [text](url) syntax with support for reference-style links that improve readability of raw Markdown.

Images — Complete Guide

Markdown images use  syntax with alt text for accessibility and optional title attributes.

Code and Syntax Highlighting — Complete Guide

Markdown code uses backticks for inline code and triple backticks for fenced code blocks with optional language highlighting.

Blockquotes — Complete Guide

Markdown blockquotes use > characters to indicate quoted content, supporting nesting and other Markdown elements inside.

Horizontal Rules — Complete Guide

Markdown horizontal rules use three or more dashes, asterisks, or underscores to create thematic breaks.

Tables — Complete Guide

Markdown tables use pipes and dashes to create tabular data with optional alignment control via colons.

Task Lists — Complete Guide

GitHub-Flavored Markdown task lists use - [] and - [x] for unchecked and checked items in issues and pull requests.

Footnotes — Complete Guide

Markdown footnotes use [^ref] syntax for references that link to definitions at the bottom of the document.

Using HTML in Markdown — Complete Guide

Markdown allows raw HTML for elements that Markdown syntax does not cover, with inline HTML working naturally.

Extended Markdown Syntax — Complete Guide

Extended syntax in different implementations adds tables, fenced code blocks, definition lists, and auto-links.

Markdown vs Other Formats — Complete Guide

Markdown balances simplicity, readability, and power compared to LaTeX, reStructuredText, AsciiDoc, and HTML.

Markdown Tools and Editors — Complete Guide

Markdown editors range from simple text editors with preview to dedicated tools like Typora, Obsidian, and VS Code.

Character Escaping — Complete Guide

Markdown backslash escaping prevents special characters like * and [] from being interpreted as formatting.

Markdown Best Practices

Consistent Markdown practices include one space after list markers, blank lines around blocks, and semantic headings.

Real-World Projects — Complete Guide

Build comprehensive documentation including README files, wikis, technical documentation, and note-taking systems using Markdown.