WARNING: This is just a temporal fork to fix a bug in the original huntertran.auto-markdown-toc extension when inserting the anchors for headers. This extension places the anchors before the header. The original extension places them after the header, making them unusable in Bitbucket.
Generate TOC (table of contents) of headlines from parsed markdown file.
- 1. Features
- 2. Installation
- 3. Usage
- 4. Configuration
- 5. Contributors
- 6. What's New?
- 7. Authors
- 8. License
- 9. Links
- Insert header number sections.
- Auto active plugin on markdown
- Insert anchor for header
<a id="markdown-header" name="header"></a>
- Linking via anchor tags
# A 1
โ#a-1
- Depth control[1-6] with
depthFrom:1
anddepthTo:6
- Enable or disable links with
withLinks:true
- Refresh list on save with
updateOnSave:true
- Use ordered list (1. ..., 2. ...) with
orderedList:true
- Anchor support for (github.com|nodejs.org|bitbucket.org|ghost.org|gitlab.com).
ext install auto-markdown-toc
Tips:Section of header is begin with depthFrom
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 |
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-6) | 1 |
markdown-toc.depthTo | number(1-6) | 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 |
If you want to use a unique setting for a file, you can add attributes to <!-- TOC -->
, just like:
<!-- TOC depthFrom:2 orderedList:true -->
<!-- /TOC -->
- sine sawtooth (Add: Header number section)
- chriscamicas (Update: Anchor generation)
- kevindaub (Add : Use workspace settings for tabs and eOL)
- rovest (Feature: Insert anchor)
- zhiguang Wang(Fix: Recognised code to header list)
- jgroom33 (Fix: Codeblock error)
- satokaz (Fix: Codeblock error)
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 was created by Alan Walk, and later updated by Hunter Tran. If you have any questions, contact them at:
- Alan Walk
- Mail : [email protected]
- Twitter : @AlanWalk93
- Github : AlanWalk
- Hunter Tran
- Mail : [email protected]
The package is Open Source Software released under the MIT License. It's developed by AlanWalk, maintained by Xavier Guarch