Markdown: Syntax

• Overview
  • Philosophy
  • Inline HTML
  • Automatic Escaping for Special Characters
• Block Elements
  • Paragraphs and Line Breaks
  • Headers
  • Blockquotes
  • Lists
  • Code Blocks
  • Horizontal Rules
• Span Elements
  • Links
  • Emphasis
  • Code
  • Images
• Miscellaneous
  • Backslash Escapes
  • Automatic Links

Note: This document is itself written using Markdown; you can see the source for it by adding ‘.text’ to the URL .

Overview

Philosophy

Markdown is intended to be as easy-to-read and easy-to-write as is feasible.

Readability, however, is emphasized above all else. A Markdown-formatted document should be publishable as-is, as plain text, without looking like it’s been marked up with tags or formatting instructions. While Markdown’s syntax has been influenced by several existing text-to-HTML filters – including Setext , atx , Textile , reStructuredText , Grutatext , and EtText – the single biggest source of inspiration for Markdown’s syntax is the format of plain text email.