# TOC plugin change? Support TOC levels

**URL:** https://discourse.joplinapp.org/t/toc-plugin-change-support-toc-levels/49817
**Category:** Features
**Created:** [10 May 2026 10:14 UTC](https://discourse.joplinapp.org/t/toc-plugin-change-support-toc-levels/49817 "2026-05-10T10:14:26Z")
**Posts on this page:** 3
**Page:** 1

<div class="post-metadata">

### Author: ![Piotr](https://avatars.discourse-cdn.com/v4/letter/p/839c29/32.png) [@Piotr](https://discourse.joplinapp.org/u/Piotr)
#### Post date: [10 May 2026 10:14 UTC](https://discourse.joplinapp.org/t/toc-plugin-change-support-toc-levels/49817/1 "2026-05-10T10:14:26Z")

</div>

Hi,

in short:

- I want levels, e.g. `[toc 3]`
- Current plugin does not support it, looks abandoned
- What can be done about this?

Longer version:

Currently it's possible to put `[toc]`in note to generate Table Of Content. But it lists all headings. I'd like to be able to optionally specify the max level to generate, for example `[toc max-level=3]` (or `[toc 3]` or whatever syntax is chosen) to generate TOC only for headings of level 1, 2, 3.

As I understand, Joplin uses [markdown-it-toc-done-right](https://github.com/nagaozen/markdown-it-toc-done-right) to handle the `[toc]`. This plugin does not support the level feature. The last commit to the repo was 6 years ago.

So I'd like to discuss if anything can be done in this case?

- does anyone knows if the plugin is actually abandoned - would it be possible to add such feature to it?
- lack of updates for 6 years makes me worried about security (dependencies... but maybe this is handled when it's integrated with Joplin?)
- if not, could we fork it and add such feature?
- otherwise, maybe choosing a different plugin would be possible?

This is assuming such feature (level configuration) is something that is useful for others, not only me.

Maybe there's already a Joplin plugin that allows this feature. I have not found it. Plus there's the issue of trust/security of external plugins...

---

<div class="post-metadata">

### Author: ![dpoulton](https://yyz2.discourse-cdn.com/flex028/user_avatar/discourse.joplinapp.org/dpoulton/32/29723_2.png) [@dpoulton](https://discourse.joplinapp.org/u/dpoulton)
#### Post date: [10 May 2026 11:23 UTC](https://discourse.joplinapp.org/t/toc-plugin-change-support-toc-levels/49817/2 "2026-05-10T11:23:09Z")

</div>

> [@Piotr](#):
>
> ... would it be possible to add such feature to it?

It has already been done! 🙂

If you want just levels 1 & 2 use

`$<toc{"level":[1,2]}>`

just 2,3 & 4 use

`$<toc{"level":[2,3,4]}>`

etc.

instead of `[TOC]`

See this [merged PR](https://github.com/laurent22/joplin/pull/2005) from 2019 for further details.

---

<div class="post-metadata">

### Author: ![Piotr](https://avatars.discourse-cdn.com/v4/letter/p/839c29/32.png) [@Piotr](https://discourse.joplinapp.org/u/Piotr)
#### Post date: [12 May 2026 18:43 UTC](https://discourse.joplinapp.org/t/toc-plugin-change-support-toc-levels/49817/3 "2026-05-12T18:43:17Z")

</div>

Thanks, I didn't find this information in documentation. A bit hard to remember as well.

But actually, I switched to Outline plugin instead. Looks like a better solution for my current needs (navigating in longer, multi-section notes).