什么是 Markdown 本地文件链接?
在使用 Markdown 编写文档时,我们经常需要引用本地的图片、PDF、Word 文档或其他资源。 通过正确的路径语法,可以在 Markdown 中创建指向这些本地文件的超链接。
基本语法
Markdown 中链接本地文件使用标准的链接语法:
[链接文字](路径/到/文件.ext)
例如:
[查看报告](docs/report.pdf)
[打开图片](images/photo.jpg)
路径类型说明
1. 相对路径(推荐)
相对路径是相对于当前 Markdown 文件所在目录的路径。 这是最常用且可移植性最好的方式。
./images/logo.png → 当前目录下的 images 文件夹
../assets/data.xlsx → 上一级目录中的 assets 文件夹
2. 绝对路径(不推荐)
绝对路径从根目录开始,如 /Users/name/project/file.docx。
这类路径在不同设备上通常无效,仅适用于特定环境(如本地预览)。
注意事项
- 确保文件路径正确,大小写敏感(尤其在 Linux/macOS 系统)。
- 部分 Markdown 渲染器(如 GitHub)出于安全考虑,会禁用本地文件链接。
- 在网页中打开 Markdown 生成的 HTML 时,浏览器可能因安全策略阻止 file:// 协议的跳转。
- 建议将所有资源放在项目目录内,使用相对路径引用。
常见问题
Q:点击链接没反应?
A:可能是渲染环境限制(如 GitHub、VS Code 预览)。尝试在本地用浏览器打开生成的 HTML 文件测试。
Q:如何链接 Word 或 Excel 文件?
A:和图片一样使用相对路径,例如:[下载表格](data/sales.xlsx)