Flavored Syntax

Specs and examples of ReadMe's (restrained) Markdown syntax extensions.

Custom Blocks

Code Tabs

A tabbed interface for displaying multiple code blocks. These are written nearly identically to a series of vanilla markdown code snippets, except for their distinct lack of an additional line break separating each subsequent block. Syntax & examples.


Callouts are very nearly equivalent to standard Markdown block quotes in their syntax, other than some specific requirements on their content: To be considered a “callout”, the block quote must start with an initial emoji, which is used to determine the callout's theme. Syntax & examples.


Embedded content is written as a simple Markdown link, with a title of "@embed". Syntax & examples.

Standard Markdown

The engine also supports all standard markdown constructs, as well as CommonMark options, and most GitHub syntax extensions.