Is [[toc]] to be preferred over [toc]

SteveShank · 2 February 2022 01:44

Joplin 2.6.10 (prod, win32)

Client ID: 3bfe3b9e803f4a3695d54544dcf3c555
Sync Version: 3
Profile Version: 41
Keychain Supported: Yes
Windows 10 and Android
Revision: 98fba37

I've noticed that most people here seem to use [[toc]] for the toc instead of the simpler [toc]. Is there a reason for this? I use a lot of toc and if I'm making a mistake I don't want to get bitten later.

graphit0 · 11 February 2022 17:27

it seems that differences are under the hood, here's a thread if you keen on digging up the truth

github.com/laurent22/joplin

[Feature Request] make [TOC] available in markdown

opened 06:42PM - 01 May 18 UTC

closed 10:07PM - 02 Apr 19 UTC

tessus

enhancement

/ref https://discourse.joplin.cozic.net/t/make-toc-available-in-markdown **Su…mmary:** I often have long notes and a Table of Contents would help a lot with navigating these notes. The common markdown keyword for a table of contents section (collapsible or not) is `[TOC]`. The reason for a keyword is that people might want to have it at the top and the bottom of a note (or somewhere within the note as well). --- The Markdown approach would indeed be simpler than creating custom UI for all three apps. Since we use markdown-it, this plugin maybe could be used: https://github.com/Oktavilla/markdown-it-table-of-contents

tessus · 11 February 2022 17:54

Place one of: ${toc} , [[toc]] , [toc] , [[_toc_]] in your markdown and, BOOM, the <nav class="table-of-contents"> will be there.

Topic		Replies	Views
Make [TOC] available in markdown Features	8	7583	1 May 2018
Support contents Features	1	589	29 December 2018
TOC for Multiple Notes Support	0	597	25 November 2020
Suggestion: Documentation for Table of Contents Features	6	1844	29 August 2021
How to use [TOC]? Support	2	8915	11 August 2021

Is [[toc]] to be preferred over [toc]

Related topics