← Back to home

Minimalist Markdown Guide for GitHub Pages

July 2025 • Nathan Cavaglione

Markdown Guide

This guide covers all the Markdown syntax you can use on GitHub Pages, with both the syntax and rendered examples for each feature.

Headings

Heading level 1

Heading level 2

Heading level 3

Heading level 4

Heading level 5
Heading level 6
# Heading level 1
## Heading level 2
### Heading level 3
#### Heading level 4
##### Heading level 5
###### Heading level 6

Paragraphs and Line Breaks

This is a paragraph.

This is another paragraph with
two spaces at the end for a line break.

This is a third paragraph.

This is a paragraph.

This is another paragraph with  
two spaces at the end for a line break.

This is a third paragraph.

Emphasis

bold text and bold text

**bold text**
__bold text__

italic text and italic text

*italic text*
_italic text_

bold and italic and bold and italic

***bold and italic***
___bold and italic___

Lists

  • First item
  • Second item
  • Third item
    • Indented item
    • Another indented item
- First item
- Second item
- Third item
  - Indented item
  - Another indented item
  1. First item
  2. Second item
  3. Third item
    1. Indented item
    2. Another indented item
1. First item
2. Second item
3. Third item
   1. Indented item
   2. Another indented item

Link text and Link with title

[Link text](https://example.com)
[Link with title](https://example.com "Title text")

Link text

[Link text][reference]

[reference]: https://example.com "Optional title"

https://example.com and fake@example.com

<https://example.com>
<fake@example.com>

Images

Alt text Alt text

![Alt text](image.jpg)
![Alt text](image.jpg "Image title")

Alt text

[![Alt text](image.jpg)](https://example.com)

Code

Use code in your text.

Use ` code ` in your text.

print("Hello, World!")

Use ``` on the line before and after

Blockquotes

First level

Second level

Third level

> First level
> 
>> Second level
>> 
>>> Third level

Horizontal Rules

---
***
___

Tables

Header 1 Header 2 Header 3
Cell 1 Cell 2 Cell 3
Cell 4 Cell 5 Cell 6 
| Header 1 | Header 2 | Header 3 |
|----------|----------|----------|
| Cell 1   | Cell 2   | Cell 3   |
| Cell 4   | Cell 5   | Cell 6   |
Left Center Right
Left Center Right 
| Left | Center | Right |
|:-----|:------:|------:|
| Left | Center | Right |

Task Lists

  • Completed task
  • Incomplete task
  • Another completed task
- [x] Completed task
- [ ] Incomplete task
- [x] Another completed task

Strikethrough

strikethrough text

~~strikethrough text~~

Escaping Characters

* Not a bullet point, ` Not inline code, [ Not a link

\* Not a bullet point
\` Not inline code
\[ Not a link

HTML Support

Click to expand Content inside the collapsible section. 
<details>
<summary>Click to expand</summary>

Content inside the collapsible section.
</details>

Footnotes

Here’s a sentence with a footnote1.

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

[^1]: This is the footnote content.

Definition Lists

Term 1
Definition 1
Term 2
Definition 2
Term 1
: Definition 1

Term 2
: Definition 2

Comments

<!-- This is a comment that won't be rendered -->

This guide covers all the major Markdown features supported by GitHub Pages. Remember that some features might vary depending on your specific Jekyll theme or configuration.

  1. This is the footnote content. ↩