概述
在编写文档时，经常需要添加目录以方便读者快速定位和查找所需内容。toc-md 是一款基于 Node.js 平台的 npm 包，可以帮助开发人员生成 Markdown 格式的目录结构，并自动根据标题的层级关系进行缩进，使得文档更加清晰易读。本文将详细介绍如何使用 toc-md 来生成目录。
安装
首先，你需要在本地安装 Node.js 和 npm。如果你还没有安装，请前往 Node.js 官网 下载并安装最新版本的 Node.js，npm 会随之自动安装。
然后，在终端中执行以下命令来安装 toc-md：
npm install -g toc-md
这里使用了 -g 参数，表示全局安装。如果你不想全局安装，也可以省略该参数，使用 npx 命令来调用 toc-md。
使用方法
假设你有一个名为 README.md 的 Markdown 文件，其中包含若干个标题。为了生成目录，你需要执行以下命令：
toc-md README.md
执行完毕后，toc-md 会在文件中插入一个名为 Table of Contents 的值，该值是一个 Markdown 格式的列表，包含了所有标题的链接。默认情况下，toc-md 会把列表插入到文件的开头，但你也可以通过指定 --insert 参数来将列表插入到任意位置。例如：
toc-md README.md --insert "# Table of Contents\n"
这里将列表插入到了一个以 # Table of Contents 为标题的一级标题下面。
除了默认的标题级别之外，你还可以通过指定 --min 和 --max 参数来限制要生成目录的标题级别范围。例如：
toc-md README.md --min 2 --max 4
这里只会在二级标题到四级标题之间生成目录。
高级用法
如果你想进一步控制 toc-md 的行为，可以使用配置文件。在项目根目录下创建一个名为 .tocrc 的文件，并在其中指定相应的配置项。以下是一个示例配置文件：
{
"min": 2,
"max": 3,
"insert": "# Table of Contents\n",
"bullet": "* "
}其中，min、max 和 insert 配置项与命令行参数的含义相同；bullet 配置项用于指定列表项的符号，默认为 - 。你可以根据需要修改这些配置项，并在终端中执行以下命令来生成目录：
toc-md --config .tocrc README.md
总结
使用 toc-md 可以快速生成 Markdown 格式的目录，方便读者浏览文档内容。在使用过程中，我们可以通过命令行参数或配置文件来控制目录的生成方式，满足不同的需求。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/42812