脚注 #

概述 #

脚注用于在文档末尾添加注释或引用，读者可以点击跳转到脚注内容。

基本语法 #

创建脚注引用 #

使用 [^标识符] 创建脚注引用：

markdown

这是一个脚注引用[^1]。

定义脚注内容 #

使用 [^标识符]: 定义脚注内容：

markdown

[^1]: 这是脚注的内容。

完整示例 #

markdown

Markdown 是一种轻量级标记语言[^1]，由 John Gruber 创建[^2]。

[^1]: 轻量级标记语言是一类用简单语法格式化文本的语言。
[^2]: John Gruber 是一位美国作家和软件开发者。

渲染效果：

Markdown 是一种轻量级标记语言^1，由 John Gruber 创建[^2]。

[^2]: John Gruber 是一位美国作家和软件开发者。

脚注位置 #

脚注定义可以放在文档任意位置，通常放在文档末尾：

markdown

# 文档标题

正文内容...[^1]

更多内容...[^2]

## 参考资料

[^1]: 参考资料1
[^2]: 参考资料2

多行脚注 #

脚注内容可以跨越多行：

markdown

[^1]: 这是第一行。
      这是第二行。
      这是第三行。

或使用缩进：

markdown

[^long]: 这是一个很长的脚注内容，
    可以跨越多行，
    保持缩进即可。

命名规则 #

使用数字 #

markdown

[^1]: 第一个脚注
[^2]: 第二个脚注

使用名称 #

markdown

[^markdown]: Markdown 相关说明
[^author]: 作者信息

命名规则 #

可以使用字母、数字、连字符
不区分大小写
建议使用有意义的名称

实际应用 #

学术引用 #

markdown

研究表明，Markdown 的学习曲线较低[^study1]，适合快速上手[^study2]。

[^study1]: Smith, J. (2020). "Markdown Learning Curve Analysis"
[^study2]: Johnson, M. (2021). "Technical Writing with Markdown"

技术文档 #

markdown

使用 `npm install` 安装依赖[^npm]。

[^npm]: npm 是 Node.js 的包管理器，用于安装和管理项目依赖。

术语解释 #

markdown

前端开发需要掌握 HTML[^html]、CSS[^css] 和 JavaScript[^js]。

[^html]: HTML（HyperText Markup Language）是用于创建网页的标准标记语言。
[^css]: CSS（Cascading Style Sheets）用于描述网页的样式和布局。
[^js]: JavaScript 是一种脚本语言，用于实现网页的交互功能。

参考资料 #

markdown

## 参考资料

- 官方文档[^docs]
- 教程网站[^tutorial]

[^docs]: [Markdown 官方文档](https://daringfireball.net/projects/markdown/)
[^tutorial]: [Markdown 教程](https://www.markdownguide.org/)

脚注样式 #

不同渲染器脚注样式可能不同：

上标数字 [1]
方括号数字 [^1]
点击跳转链接

兼容性 #

平台	支持情况
GitHub	支持
GitLab	支持
Obsidian	支持
Typora	支持
部分 Markdown 解析器	不支持

常见问题 #

问题1：脚注不显示 #

检查：

脚注定义是否正确
标识符是否匹配
平台是否支持

问题2：脚注编号错误 #

markdown

正确：
[^1]: 第一个
[^2]: 第二个

错误：
[^1]: 第一个
[^1]: 重复标识符

问题3：脚注内容不完整 #

markdown

正确：
[^1]: 完整的脚注内容。

错误：
[^1]: 脚注内容没有结束

最佳实践 #

1. 放在文档末尾 #

markdown

正文内容...

---

## 参考资料

[^1]: 参考资料1
[^2]: 参考资料2

2. 使用有意义的标识符 #

markdown

好的：
[^markdown]: Markdown 说明
[^author]: 作者信息

不好的：
[^1]: 说明
[^2]: 信息

3. 保持脚注简洁 #

markdown

好的：
[^1]: 简短说明。

不好的：
[^1]: 这是一个非常长的脚注内容，包含大量信息，应该考虑放在正文中...

下一步 #

继续学习定义列表！