如果你是一个前端工程师，那么你一定知道使用 Markdown 对于编写详细的文档是非常方便的。Markdown 语法简单易懂，而且功能丰富，但是有时候，我们需要给文档中的标题增加锚点，这时候就需要使用 npm 包 @bouzuya/expand-markdown-anchors 了。
什么是 @bouzuya/expand-markdown-anchors
@bouzuya/expand-markdown-anchors 是一个可以自动生成 Markdown 锚点的 npm 包。它会扫描你的 Markdown 文档中的标题，并且自动生成与之对应的锚点。这样，你就可以方便地在文档中添加跳转链接，提高文档的可读性。
安装 @bouzuya/expand-markdown-anchors
要使用 @bouzuya/expand-markdown-anchors 包，首先需要全局安装它。可以使用下面的命令进行安装：
npm install -g @bouzuya/expand-markdown-anchors
安装完成后，我们就可以使用它来生成 Markdown 锚点了。
使用 @bouzuya/expand-markdown-anchors
使用 @bouzuya/expand-markdown-anchors 包非常简单。只需要在命令行中进入 Markdown 文件所在目录，然后使用下面的命令：
expand-markdown-anchors input.md output.md
其中 input.md 是你要处理的 Markdown 文件名，output.md 是生成的带有锚点的 Markdown 文件名，也可以直接在输入文件上修改。
例如，我们有一个名为 example.md 的 Markdown 文件，其中包含了一些标题，比如：
# 标题一 ## 子标题一 ## 子标题二 # 标题二 ## 子标题三 ## 子标题四
我们可以使用下面的命令来生成带有锚点的 Markdown 文件：
expand-markdown-anchors example.md example-with-anchors.md
执行完上面的命令后，我们就会得到一个名为 example-with-anchors.md 的新文件，它的内容如下：
-- -------------------- ---- ------- - --- -- --------------- -- ---- -- ---------------- -- ---- -- ---------------- - --- -- --------------- -- ---- -- ---------------- -- ---- -- ----------------
我们可以看到，每个标题都会在下面自动生成一个锚点，并且锚点的名称与标题的内容完全一致。这样，我们就可以方便地在文档中添加跳转链接了。
结语
总之，@bouzuya/expand-markdown-anchors 包是一个非常有用的工具，可以大大提高我们编写文档的效率。希望这篇简短的教程能够帮助你快速上手，并且在以后的工作中给你带来便利。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6006735c890c4f7277583fed