# a post with table of contents

March 20, 2023

[** 2023](https://alextisyoung.com/blog/2023) · [** formatting](https://alextisyoung.com/blog/tag/formatting) [** toc](https://alextisyoung.com/blog/tag/toc) · [** sample-posts](https://alextisyoung.com/blog/category/sample-posts)

- [Adding a Table of Contents](https://alextisyoung.com/blog/2023/table-of-contents/#adding-a-table-of-contents)
  - [Example of Sub-Heading 1](https://alextisyoung.com/blog/2023/table-of-contents/#example-of-sub-heading-1)
  - [Example of another Sub-Heading 1](https://alextisyoung.com/blog/2023/table-of-contents/#example-of-another-sub-heading-1)

- [Table of Contents Options](https://alextisyoung.com/blog/2023/table-of-contents/#table-of-contents-options)
  - [Example of Sub-Heading 2](https://alextisyoung.com/blog/2023/table-of-contents/#example-of-sub-heading-2)
  - [Example of another Sub-Heading 2](https://alextisyoung.com/blog/2023/table-of-contents/#example-of-another-sub-heading-2)

---

This post shows how to add a table of contents in the beginning of the post.

## Adding a Table of Contents

To add a table of contents to a post, simply add

```
toc:
  beginning: true
```

to the front matter of the post. The table of contents will be automatically generated from the headings in the post.

### Example of Sub-Heading 1

Jean shorts raw denim Vice normcore, art party High Life PBR skateboard stumptown vinyl kitsch. Four loko meh 8-bit, tousled banh mi tilde forage Schlitz dreamcatcher twee 3 wolf moon. Chambray asymmetrical paleo salvia, sartorial umami four loko master cleanse drinking vinegar brunch. [Pinterest](https://www.pinterest.com) DIY authentic Schlitz, hoodie Intelligentsia butcher trust fund brunch shabby chic Kickstarter forage flexitarian. Direct trade [cold-pressed](https://en.wikipedia.org/wiki/Cold-pressed_juice) meggings stumptown plaid, pop-up taxidermy. Hoodie XOXO fingerstache scenester Echo Park. Plaid ugh Wes Anderson, freegan pug selvage fanny pack leggings pickled food truck DIY irony Banksy.

### Example of another Sub-Heading 1

Jean shorts raw denim Vice normcore, art party High Life PBR skateboard stumptown vinyl kitsch. Four loko meh 8-bit, tousled banh mi tilde forage Schlitz dreamcatcher twee 3 wolf moon. Chambray asymmetrical paleo salvia, sartorial umami four loko master cleanse drinking vinegar brunch. [Pinterest](https://www.pinterest.com) DIY authentic Schlitz, hoodie Intelligentsia butcher trust fund brunch shabby chic Kickstarter forage flexitarian. Direct trade [cold-pressed](https://en.wikipedia.org/wiki/Cold-pressed_juice) meggings stumptown plaid, pop-up taxidermy. Hoodie XOXO fingerstache scenester Echo Park. Plaid ugh Wes Anderson, freegan pug selvage fanny pack leggings pickled food truck DIY irony Banksy.

## Table of Contents Options

If you want to learn more about how to customize the table of contents, you can check the [jekyll-toc](https://github.com/toshimaru/jekyll-toc) repository.

### Example of Sub-Heading 2

Jean shorts raw denim Vice normcore, art party High Life PBR skateboard stumptown vinyl kitsch. Four loko meh 8-bit, tousled banh mi tilde forage Schlitz dreamcatcher twee 3 wolf moon. Chambray asymmetrical paleo salvia, sartorial umami four loko master cleanse drinking vinegar brunch. [Pinterest](https://www.pinterest.com) DIY authentic Schlitz, hoodie Intelligentsia butcher trust fund brunch shabby chic Kickstarter forage flexitarian. Direct trade [cold-pressed](https://en.wikipedia.org/wiki/Cold-pressed_juice) meggings stumptown plaid, pop-up taxidermy. Hoodie XOXO fingerstache scenester Echo Park. Plaid ugh Wes Anderson, freegan pug selvage fanny pack leggings pickled food truck DIY irony Banksy.

### Example of another Sub-Heading 2

Jean shorts raw denim Vice normcore, art party High Life PBR skateboard stumptown vinyl kitsch. Four loko meh 8-bit, tousled banh mi tilde forage Schlitz dreamcatcher twee 3 wolf moon. Chambray asymmetrical paleo salvia, sartorial umami four loko master cleanse drinking vinegar brunch. [Pinterest](https://www.pinterest.com) DIY authentic Schlitz, hoodie Intelligentsia butcher trust fund brunch shabby chic Kickstarter forage flexitarian. Direct trade [cold-pressed](https://en.wikipedia.org/wiki/Cold-pressed_juice) meggings stumptown plaid, pop-up taxidermy. Hoodie XOXO fingerstache scenester Echo Park. Plaid ugh Wes Anderson, freegan pug selvage fanny pack leggings pickled food truck DIY irony Banksy.

Source: [a post with table of contents | Alexander Strudwick Young](https://alextisyoung.com/blog/2023/table-of-contents/)