Writing Content
Learn about how to write Markdown content for your site.
docs.page supports writing Markdown in the GFM (GitHub Flavored Markdown) format. This means you can write your content in a familiar format and it will be rendered as HTML.
Alongside this, you may notice the file extension for your content is .mdx
(instead of .md
). This is because docs.page supports MDX,
which allows you to write JSX inside your Markdown files. This means you can write JSX components inside your Markdown files too!
Headings
Use the #
symbol to create headings. The more #
symbols you use, the smaller and less semantic weight the heading will have:
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6
Blockquotes
To create a blockquote, add a > in front of a paragraph.
Example of a blockquote.
> Example of a blockquote.
Unordered
To create an unordered list, use the -
symbol:
- Item 1
- Item 2
- Item 3
- Item 1
- Item 2
- Item 3
Ordered
To create an ordered list, use a numeric value as a prefix:
- Item 1
- Item 2
- Item 3
1. Item 1
2. Item 2
3. Item 3
Code Blocks
To create a code block, use three backticks:
echo "Hello World"
```
echo "Hello World"
```
You can specify a language to provide automatic syntax highlighting:
console.log('Hello World');
```js
console.log('Hello World');
```