Writing Markdown

MkDocs supports regular Markdown syntax with some Github Flavored Markdown extensions.

For other references on writing in Markdown, see the GitHub documentation, the Markdown Guide, or the author's original documentation.

The rest of this page provides a reference guide to the supported markdown syntax.

Headings

# H1
## H2
### H3
#### H4
##### H5

H1

H2

H3

H4

H5

Formatting

* **Bold text**
* *Italic text*
* ~~Strikethrough~~
* <ins>Underlined</ins>
* e <sup>i π</sup> = -1
* H<sub>2</sub>O

Lists

- First item
- Second item
- Third item

Ordered Lists

1. First item
2. Second item
3. Third item

  1. First item
  2. Second item
  3. Third item
See [wikipedia](https://www.wikipedia.org/).

See wikipedia.

See the [Links](#links) section.

See the Links section.

Back to the [Homepage](index.md).

Back to the Homepage.

Images

![coder cat](img/codercat.png)

coder cat

Inline Code

`&mdash;`

&mdash;

Code Block

```json
{
  "firstName": "John",
  "lastName": "Smith",
  "age": 25
}
```

{
  "firstName": "John",
  "lastName": "Smith",
  "age": 25
}

Horizontal Rule

---


Table

| Syntax    | Description |
| --------- | ----------- |
| Header    | Title       |
| Paragraph | Text        |

Syntax Description
Header Title
Paragraph Text

Footnotes

Here's a sentence with a footnote. [^1]

[^1]: This is the footnote from earlier.

Here's a sentence with a footnote. 1

Blockquote

> Rumors of my death have been greatly exaggerated.

Rumors of my death have been greatly exaggerated.

Alerts

> [!NOTE]
> Useful information that users should know, even when skimming content.

[!NOTE] Useful information that users should know, even when skimming content.

> [!TIP]
> Helpful advice for doing things better or more easily.

[!TIP] Helpful advice for doing things better or more easily.

> [!IMPORTANT]
> Key information users need to know to achieve their goal.

[!IMPORTANT] Key information users need to know to achieve their goal.

> [!WARNING]
> Urgent info that needs immediate user attention to avoid problems.

[!WARNING] Urgent info that needs immediate user attention to avoid problems.

> [!CAUTION]
> Advises about risks or negative outcomes of certain actions.

[!CAUTION] Advises about risks or negative outcomes of certain actions.

Emoji

:+1: This PR looks great :heart:

👍🏼 This PR looks great ❤️

Task List

- [x] Write the press release
- [ ] Update the website
- [ ] Contact the media

  1. This is the footnote from earlier. ↩