15---脚注(footnote)

本节我们来学习markdown的脚注

一、脚注的基本使用:

当使用Markdown编写文档时,有时我们希望在文本中插入一些额外的注释或解释,这时可以使用脚注(footnote)来实现。脚注是一种注释形式,通常以数字或符号的形式出现在文本中,用户可以点击或悬停在脚注标记上以查看注释内容。

在Markdown中创建脚注非常简单,可以按照以下步骤操作:

  1. 在需要插入脚注的文本位置,使用方括号( )来标记脚注的位置 ,例如:这是一个需要注释的文本[^1]。[1](#1)
  2. 在文档的其他位置,使用相同的脚注标记([^1])来定义 脚注的内容,例如:[^1]: 这是一个脚注的解释内容。
  3. 将脚注的定义 放在文档的任意位置,通常建议放在文档的末尾。
  • 当你使用脚注标记时,Markdown会自动为脚注创建一个超链接,用户可以点击该链接或悬停在上面以查看脚注的内容。脚注的内容会以类似于引用的形式出现在文档的末尾,包括脚注标记和对应的解释内容。

  • 但需要注意的是,不同的Markdown编辑器可能会对脚注的呈现方式有所不同。有些编辑器会在脚注的位置直接显示脚注内容,而有些编辑器则会将脚注内容放在文档末尾。

总之,脚注是一种方便的方式来为文本提供注释或解释,使得文档更加易读和易懂。


二、扩展的脚注功能:

除了基本的脚注功能外,Markdown还提供了一些扩展的脚注功能,可以进一步定制脚注的样式和呈现方式。以下是一些常见的扩展功能:

  1. 自定义脚注标记 :默认情况下,脚注标记是按照数字的顺序进行排序的(例如:[^1]、[^2]、[^3])。但是,你也可以使用自定义的标记来替代数字,例如:这是一个需要注释的文本[^注释]。,然后在其他位置定义脚注内容时,使用相同的自定义标记([^注释])。

  2. 多行脚注内容:默认情况下,脚注的内容只能是单行文本。但是,有些Markdown编辑器支持多行脚注内容的显示。你可以在脚注的定义中使用多行文本,例如:

markdown 复制代码
[^1]: 这是一个多行脚注的解释内容。
    这是第二行。
  • 其中,每一行的开头需要缩进四个空格或一个制表符。
  1. HTML标签和样式:有些Markdown编辑器支持在脚注的定义中使用HTML标签,以进一步定制脚注的样式。你可以在脚注的定义中使用HTML标签来设置字体、颜色、大小等样式。
  2. 脚注作为变量:可以使用脚注来存储一些较长或复杂的内容,比如图片地址、链接地址等。这样可以提高文档的可读性和可维护性。
  • 以下是一个示例,展示了如何使用脚注来引用图片地址:
markdown 复制代码
这是一段文本,其中包含了一张图片[^2]。

[^2]: 图片地址:https://markdown-here.com/img/icon256.png
  • 在这个示例中,我们将图片[2](#2)地址存储在脚注中,并使用[^2]来引用该脚注。这样,即使图片地址非常长,也不会影响到文本的可读性。

  • 需要注意的是,这些扩展功能的可用性取决于你所使用的Markdown编辑器,不同的Markdown编辑器对脚注的支持程度可能有所不同。有些编辑器可能无法正确解析并显示脚注中的链接地址。因此,在使用脚注存储重要信息时,建议事先测试并确认编辑器的具体特性和支持程度

总结起来,Markdown的脚注功能可以通过简单的标记和定义来实现注释或解释的插入。同时,一些Markdown编辑器还提供了一些扩展功能,如自定义标记、多行内容和HTML样式,以进一步定制脚注的样式和呈现方式。😄


三、注意事项:

在使用Markdown脚注时,还有一些需要注意的地方:

  1. 不同的Markdown编辑器支持的脚注功能可能有所不同,因此在使用脚注之前,建议先了解你所使用的编辑器的具体特性和支持程度。

  2. 脚注的定义 应该放在文档的其他位置,通常建议放在文档的末尾。这样可以保持文档的整洁和易读性。

  3. 在定义脚注时,脚注标记应该是唯一的,不能重复使用。否则,可能会导致脚注内容显示错误或混乱。

  4. 脚注的内容应该简洁明了,避免过长或过多的解释。脚注的作用是提供一些额外的注释或解释,而不是替代主要内容。

  5. 在使用脚注时,建议遵循一致的风格和格式,使得文档的样式统一。例如,可以使用相同的字体、字号和颜色来呈现脚注内容。

  6. 在使用HTML标签和样式进行脚注定制时,应该注意不要过度使用或滥用。过多的样式和标签可能会导致脚注内容难以阅读或混乱。

  • 总之,使用Markdown脚注时,需要注意编辑器的支持程度、脚注的位置和格式、脚注内容的简洁性以及样式的一致性。遵循这些注意事项可以使得脚注更加清晰、易读和易懂。

  1. https://blog.csdn.net/weixin_73453526?type=blog ↩︎

  2. 图片地址:https://markdown-here.com/img/icon256.png ↩︎

相关推荐
杨凯凡7 小时前
IT日报|2026-11-20:欧盟 AI 网络攻击、Valkey 9.2、GitHub 企业迁移
人工智能·github
TunerT_TQ8 小时前
Terraform OCI Provider 2026:工具链的骨架清晰可见,CRUD 的肌肉必须由你亲自验证
github
prince_zxill8 小时前
把 17 个散文件装进一个文件夹:拆解 claude-plugins-official 的插件打包术(47,413 Star 实测)
python·github·agent·mcp·claude code
wflynn8 小时前
GitHub 日榜趋势速报 | 2026-11-20
开源·github
狮子座的男孩9 小时前
html+css基础:31、响应式布局(媒体类型,媒体特性,运算符,常用阈值)
前端·css·经验分享·html·响应式布局·媒体类型/特性·常用阈值
SemiTris10 小时前
Web 前端底层起源:HTML/CSS/JS、浏览器与 HTTP 完整脉络
http·html
TunerT_TQ10 小时前
【开源评测】google-labs-code/stitch-skills:从设计交接到可检查的组件产物
github
狮子座的男孩10 小时前
html+css基础:32、BFC(父子元素防止 margin 塌陷,父子元素清除浮动,兄弟元素两栏布局)
前端·css·经验分享·html·bfc·margin塌陷·清除浮动
zhanlang021710 小时前
HTML 零基础入门到企业实战全套教程【第八章 8.3】HTML5 语义化标签|SEO 优化、页面布局实战应用
前端·html·html5
一条Go12 小时前
探测规则:为什么它是告警规则的一种,而不是独立的任务体系
后端·架构·github