Markdown 带图片导出完整指南

为什么导出带图片的Markdown文档会出问题？

Markdown本身是一种轻量级标记语言，图片通过链接引用（如 ![alt](path)）。但在导出为PDF或Word时，若路径不正确、资源未嵌入或工具不支持，图片可能丢失或无法显示。

推荐解决方案

• 使用本地绝对路径或相对路径：确保图片与Markdown文件在同一目录或子目录下。
• 使用支持嵌入图片的编辑器：如 Typora、Obsidian、VS Code + 插件。
• 通过 Pandoc 转换：强大命令行工具，可将Markdown连同图片一并转换为PDF（需LaTeX）或Word。
• 导出前预览确认：多数现代编辑器提供“所见即所得”预览功能。

Typora 导出带图PDF示例

1. 打开你的 .md 文件，确保图片能正常显示。
2. 点击菜单栏【文件】→【导出】→【PDF】。
3. 选择保存位置，Typora 会自动嵌入图片到PDF中。

注意：图片建议使用相对路径，如 ./images/photo.png。

Pandoc 命令行导出（高级用户）

pandoc document.md -o output.pdf --pdf-engine=xelatex

对于Word输出：

pandoc document.md -o output.docx

Pandoc 会自动处理本地图片路径，但网络图片需确保可访问。