Markdown技巧-自动生成目录
1. 使用 Markdown-TOC
步骤 1:使用 npm 安装 markdown-toc
shell
npm install markdown-toc -g步骤 2:生成目录
shell
markdown-toc README.md在上面的命令中, README.md 是您的 Markdown 文件名。输入此命令将自动生成一个 Markdown 目录。
步骤 3:将目录插入 Markdown 文件中
将生成的目录复制到您的 Markdown 文件中。请注意,Markdown-TOC 工具会将目录插入到文件中包含 <!--toc--> 标记的位置。
2. 使用 doctoc
步骤 1:使用 npm 安装 doctoc
shell
npm install -g doctoc步骤 2:生成目录
shell
doctoc README.md在上面的命令中, README.md 是您的 Markdown 文件名。输入此命令将自动生成一个 Markdown 目录。
步骤 3:将目录插入 Markdown 文件中
doctoc 工具会将目录插入到文件中包含 <!--- START doctoc --> 和 <!--- END doctoc --> 标记之间的位置。您可以将这些标记插入到 Markdown 文件中,然后运行 doctoc 命令以生成和更新目录。
3.vscode 工具自动生成目录
(1)Markdown Preview Enhanced
Ctrl + Shift + P
然后选择
Markdown Preview Enhanced:Created TOC
或通过下面命令行自动生成目录
xml
<!-- @import "[TOC]" {cmd="toc" depthFrom=1 depthTo=6 orderedList=false} -->保存后如下:
markdown
<!-- code_chunk_output --> - [一级标题](#一级标题) - [二级标题](#二级标题) - [符号 转义符](#符号-转义符) - [命令行生成目录](#命令行生成目录) - [1. 使用 Markdown-TOC](#1-使用-markdown-toc) - [2. 使用 doctoc](#2-使用-doctoc) - [vscode 工具](#vscode-工具) <!-- /code_chunk_output -->(2)Markdown All in One
ctrl+shift+P 输入Markdown All in One: Create Table of Contents
4.手写链接
5.'TOC'标签生成目录
[TOC]
注意: Markdown 可以使用[TOC]自动生成 Markdown 文件的标题目录,比如在 typora,vscode(需要插件)等本地编辑器中。
但是在网页上比如:Github 不支持[TOC]标签,所以在 Github 的 README.md 上使用[TOC]无法正确显示目录。