跳转至

脚注

简介#

HTML 上的脚注,实际上是一种锚点,Markdown 在某个实现中,设计了下面的语法:

这是一句话,[^1]仅仅是一句话。[^2][^3]

---

[^1]: 这是这句话的注释,仅仅是个注释。
[^2]: 这是仅是一句话的注释。
[^3]: 再来一句话。

自定义#

由于 MkDocs 的 Markdown 渲染出的脚注是像下面这样的情况:

示例

这是一句话,1仅仅是一句话。23


  1. 这是这句话的注释,仅仅是个注释。
  2. 这是仅是一句话的注释。
  3. 再来一句话。

显然以上的效果并不好,因为脚注的数字没有方括号,Wikipedia 这样包含大量引用的百科显然必须用上方括号,才方便用户使用。

所以需要对 MkDocs 进行调整,由于 python-markdown 没有可以设置的地方,所以大概只能设置 CSS 了,我参考了 GeekThis 的代码,让脚注标记呈现为方括号,1并且增加了脚注标记不可复制的特性,这样应该对于快速复制这些文字有帮助。

(由于更新时间是手动更新的,所以部分页面内容已更新,但忘记修改新的日期了……)