集成 markdown-it-footnote 脚注系统

有时需要对文章中的某些术语或特殊版本信息进行脚注标注。原生的 Markdown 规范并不支持复杂的脚注标记，手写 <sup>[1]</sup> 标签不仅繁琐，而且无法实现脚注的双向锚点联动。

为此，本站引入并配置了 markdown-it-footnote，以实现了更好的阅读排版。

1. 为什么使用 markdown-it-footnote 扩展？ ​

虽然可以用原生的 HTML 格式手写上标，例如 <sup>[1]</sup>，但它的弊端非常明显：

• 编写效率低：每次需要手动编写带有特定样式的标签。
• 无双向跳转交互：无法实现点击角标自动滚动定位到页底注解，更无法从页底注解直接一键回跳到原句。
• 不符合语义化：底部的脚注说明混杂在普通文章文本中，缺乏规范的统一归集和样式修饰。

通过挂载专业的 markdown-it-footnote 插件，在文章中使用极其精炼的 [^1] 即可获得：

1. 右上角悬浮动效超链接 [1]。
2. 页面最底部自动生成的水平分割线（<hr>）与按序自动收集的脚注列表。
3. 完美双向锚点跳转：点击文中的 [1] 会平滑滚动至底部该条注解；点击底部注解尾部的 回跳小箭头（↩），能瞬间折返回刚才所在的阅读行。

2. 安装与配置挂载 ​

2.1 安装扩展库 ​

在博客项目根目录下安装 markdown-it-footnote 库：

npm install markdown-it-footnote

2.2 挂载到 VitePress 编译器 ​

在主题的配置文件中导入并注册该插件。这样在整个站点构建时，Markdown 编译器就能天然识别并转换脚注语法。

// .vitepress/theme/utils/markdownConfig.mjs
import footnote from "markdown-it-footnote";

const markdownConfig = (md, themeConfig) => {
  // 挂载 markdown-it 脚注扩展插件
  md.use(footnote);
  
  // 其余 timeline/card 容器与 renderer 配置...
};

3. 文章编写格式示例 ​

在 Markdown 原文中，您可以像下面这样简单书写：

各版本 MC 与 Java 对应关系如下。

| Minecraft 版本 | 适用的 Java 版本 | 推荐安装的 Java 版本 |
|:--------:|:--------:|:--------:|
| 1.20.5 - 1.21.11  | Java 17-21  | Java 21  |
| 26.0 - 26.x (2026+)[^1]  | Java 25+  | Java 25  |

[^1]: 从 2026 年开始，Minecraft 的版本号开始以年份命名，而不是之前的方式（如 26.x 对应 2026 年）。

VitePress 构建阶段会自动提取 [^1] 语法，并在网页端和底层分别自动生成优雅、响应式的脚注列表与穿梭超链接。至此，博客完成了完美的文献级排版进化！