Markdown

Last updated 3 months ago

Markdown is a popular markup syntax that's widely known for it's simplicity and popularity on the Web. GitBook supports it as a keyboard-friendly way to write rich and structured text.

To learn more about Markdown itself, visit http://commonmark.org/help/. If you find a feature of Markdown that is not supported by GitBook, please open a feature request on our Canny.

Text formatting

We support all the classic inline Markdown formatting:

Formatting

Markdown version

Result

Bold

**bold**

text

Italic

_italic_

italic

Strikethrough

~strikethrough~

strikethrough

Titles

  • Heading 1: # A first-level title

  • Heading 2: ## A second-level title

  • Heading 3: ### A third-level title

Code blocks

```⏎ creates a new code block.

```py⏎ creates a new code block with Python syntax highlighting.

Lists

We automatically detect ordered and un-ordered lists as you type. Begin a line with - or * to start a bullet list. Being a line with 1. to start a numbered list. Use Tab to go one level deeper, and Shift+Tab to go up.

Quotes

Begin a line with > to make a block quote.