Block Elements
Markdown items that structure content at block level.
Headings, lists, blockquotes, code blocks, and other core block structures.
Headings
Headings mark the start of a section and establish its rank in the document hierarchy. Markdown provides six levels, written by prefixing a line with one to six # characters. Renderers map these to the equivalent heading tags in the output, and table-of-contents tools use them to generate navigati...
Paragraph
A paragraph is the default block container for prose in Markdown. It is formed by one or more consecutive lines of text, separated from adjacent blocks by one or more blank lines. Syntax This is the first paragraph. It can span multiple l...
Thematic Break
A thematic break signals a shift in topic or scene within a section, rendered as a horizontal rule across the page. It is written as three or more -, *, or _ characters on a line of their own, with optional spaces between them. Syntax ...
Blockquote
A blockquote wraps content in a visually indented container, conventionally used for quoted or cited material. Each line of the blockquote is prefixed with a > character and an optional space. Syntax > This is a blockquote. It can span...
Unordered List
An unordered list presents a sequence of items without implying any particular order. Each item is introduced by a list marker - a -, *, or + character followed by a space - and the items render as a bulleted list. Syntax - First it...
Ordered List
An ordered list presents a sequence of items where the order is significant. Each item is introduced by a numeral followed by a . or ) and a space, and the items render as a numbered list. Syntax 1. First item 1. Second item 1. Third...
Fenced Code Block
A fenced code block displays verbatim, monospaced content — typically source code — without any Markdown processing inside it. It is delimited by a line of three or more backticks or tildes, with an optional language tag on the opening fence for syntax highlighting. Syntax...
Indented Code Block
An indented code block is a verbatim, monospaced block created by indenting every line of content by four spaces or one tab. It is the original code block syntax from the 2004 Markdown specification, predating fenced blocks. Syntax Normal...
HTML Block
An HTML block is a section of raw HTML passed through to the rendered output unchanged. It allows authors to use HTML elements not available in Markdown syntax — such as , , or custom components — directly within a Markdown document. Syntax ...
Admonitions
An admonition is a styled callout block that draws attention to a particular piece of content — a tip, a warning, a note, or similar. Admonitions are not part of the original Markdown specification; they are extensions added by specific platforms and tools. Syntax...