Markdown 链接本地文件完全指南

什么是 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)