huntertran / markdown-toc

Auto MarkdownTOC (Table Of Contents) plugin for Visual Studio Code.
https://marketplace.visualstudio.com/items?itemName=huntertran.auto-markdown-toc
MIT License
39 stars 25 forks source link

Auto Markdown TOC

Generate TOC (table of contents) of headlines from parsed markdown file.

Marketplace Version Rating Node CI

1. Features

2. Installation

ext install auto-markdown-toc

3. Usage

3.1. Insert TOC

Insert TOC

3.2. Insert Header Number Sections

Tips:Section of header is begin with depthFrom

Insert Header Number Sections

3.3. Ignore Header

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

4. Configuration

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
    },

4.1. Default Settings

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

4.2. Unique Settings

<!-- TOC depthFrom:2 orderedList:true -->

<!-- /TOC -->

5. Contributors

6. What's New?

CHANGELOG

7. Authors

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:

8. License

The package is Open Source Software released under the MIT License. It's developed by AlanWalk, maintained by Hunter Tran

9. Links