Markdown 链接本地文件指南

在使用 Markdown 编写文档（如笔记、静态网页、博客等）时，你可能需要引用本地的文件，比如图片、PDF、Word 文档或其他资源。本文将详细介绍如何在 Markdown 中正确链接本地文件。

基本语法

Markdown 使用以下语法创建链接：

[链接文字](文件路径)

链接本地图片

例如，当前目录下有一个名为 example.jpg 的图片：

![示例图片](example.jpg)

链接本地 PDF 或文档

假设你有一个 PDF 文件 report.pdf 放在 docs/ 子目录中：

[查看报告](docs/report.pdf)

相对路径 vs 绝对路径

• 相对路径（推荐）：如 ./images/photo.png 或 ../files/doc.docx，适用于项目结构清晰的场景。
• 绝对路径：如 /Users/name/Documents/file.pdf，通常不适用于网页环境，仅在本地预览器（如 Typora、Obsidian）中有效。

注意事项

• 大多数在线平台（如 GitHub、GitLab）不支持直接链接到用户本地文件，仅支持仓库内的相对路径。
• 在静态网站生成器（如 Hugo、Jekyll）中，请确保文件位于 static 或对应资源目录中。
• 某些 Markdown 编辑器（如 Obsidian、Typora）支持高级本地链接功能，包括内部跳转和附件管理。

常见问题

Q：为什么点击链接没反应？
A：可能是路径错误，或浏览器出于安全限制阻止了本地文件访问（尤其是 file:// 协议）。建议在本地服务器环境中测试（如使用 Live Server 插件）。

Q：能否链接到桌面或其他系统目录？
A：技术上可以（如 [打开桌面文件](file:///C:/Users/Name/Desktop/test.docx)），但现代浏览器通常会阻止此类操作，且不具备可移植性。