Generate TOC (table of contents) of headlines from parsed markdown file.
<a id="markdown-header" name="header"></a>
# A 1
→ #a-1
depthFrom:1
and depthTo:6
withLinks:true
updateOnSave:true
orderedList:true
ext install auto-markdown-toc
Tips:Section of header is begin with depthFrom
To ignore a header, you can add the line <!-- TOC ignore:true -->
above the header to be ignored.
<!-- TOC ignore:true -->
# Header to be ignored
# Header that should not be ignored
attributes | values | defaults |
---|---|---|
depthFrom | uint(1-6) | 1 |
depthTo | uint(1-6) | 6 |
bulletCharacter | string | "-" |
insertAnchor | bool | false |
withLinks | bool | true |
orderedList | bool | false |
updateOnSave | bool | true |
anchorMode | github.com/bitbucket.org/ghost.org/gitlab.com | github.com |
By default, vscode
use 4 spaces for tab. You can change that number specifically for markdown by adding this to your settings.json
"[markdown]": {
"editor.tabSize": 2
},
To change the default configuration settings for the Auto Markdown TOC
extension, edit the user or workspace settings as described here. The available settings are as follows:
attributes | values | defaults |
---|---|---|
markdown-toc.depthFrom | number | 1 |
markdown-toc.depthTo | number | 6 |
markdown-toc.bulletCharacter | string | "-" |
markdown-toc.insertAnchor | bool | false |
markdown-toc.withLinks | bool | true |
markdown-toc.orderedList | bool | false |
markdown-toc.updateOnSave | bool | true |
markdown-toc.anchorMode | enum | github.com |
<!-- TOC depthFrom:2 orderedList:true -->
<!-- /TOC -->
This forked repository is maintained by me and anyone who would like to contribute. The EOL fixed was contributed by roborourke and any one open new pull request with the hope of fixing the problem.
The original code is created by Alan Walk. If you have any questions, contact him at:
The package is Open Source Software released under the MIT License. It's developed by AlanWalk, maintained by Hunter Tran