如何在 Hexo 博客文章中实现文档间跳转

本文属于合集：星际餐馆修建报告

在 Hexo 中，文档间跳转是通过特定的 Markdown 链接语法或 Hexo 特有的标签插件来实现的。这为文章的相互引用提供了便利，从而增强了用户体验。本文旨在介绍如何在 Hexo 博客文章中使用这些机制来实现文档间的跳转。

改进的 Markdown 链接

直接在编辑markdown 时复制文件可使用Markdown语法来可链接到其他文档。例如，如果你想链接到同一目录下的 hello-world.md 文件，可以这样写：[hello-world](hello-world.md) 。

为了让链接直接指向生成的网页，你可以在链接的路径前加上 / 并去掉 .md 后缀。例如：

1	[hello-world.Md](/hello-world)

缺点是这样做似乎不能引用不同层级文件夹的文件，如当前文档为 site 合集下的文章，所在位置 source/_posts/site/first-blog.md 无法引用 source/_posts/hello-world.md 文件，解决方法为使用 post_link 标签。

Hexo 提供了 post_link 标签插件，使得链接到其他文章变得更加方便。使用这个标签，Hexo 会自动生成正确的 URL。你只需要提供目标文章的文件名（不包括 .md 后缀）即可，如果愿意，还可以添加一个自定义的标题。例如：

1	{% post_link filename [title] [escape] %}

例如：

1 2	{% post_link hello-world %} {% post_link hello-world 你好世界 %}

只要帖子的文件名是 hello-world.md ，即使帖子位于 source/_posts/2024-02-my-site-posts 并有永久链接 2024/02/07/hello-world。

注意

{% post_link 'site/Stellar 主题中添加分类索引 Widget' 'Stellar 主题中添加分类索引 Widget' %}
测试：Stellar 主题中添加分类索引 Widget

如果你想链接到一个特定的章节，可以在 post_link 标签或改进的 Markdown 链接后加上 # 和章节标题。例如：

1
2
3

[2024-2-4.Md位置跳转]({% post_path '2024-2-4' %}#朝鲜进行巡航导弹超大型战斗部威力试验和新型防空导弹试射)

[2024-2-4.Md](/2024-2-4#朝鲜进行巡航导弹超大型战斗部威力试验和新型防空导弹试射)

这样，点击链接后将直接跳转到页面上的特定章节。