将Obsidian Markdown 转换为 MS Word、Power Point - Pandoc
如果您有一篇使用 Obsidian 组织良好的文章,您可能偶尔需要与同事或朋友分享。 Obsidian 本身提供了导出为 PDF 文件的功能,但如果你想以可修改的 Word(docx) 或 Power Point(pptx) 文件的形式共享,复制和粘贴大量新文件是一个麻烦的事情。麻烦。
所以,我想介绍一下 Pandoc,一个 Obsidian 社区插件,可以让这个任务变得更容易。
什么是 Pandoc?
Pandoc 是一个用于从一种标记格式转换为 PDF、MS Word 和 PowerPoint 以及 Markdown、HTML 和 LaTeX 的库。基本上,它是一个 CLI 工具,可以在 Windows Powershell 或 Linux 终端中用作命令。
不过,由于使用命令进行文档转换比较复杂,因此 Pandoc 以插件的形式提供,以便您可以在 GUI 环境中轻松使用 Pandoc。如果您在 Obsidian 的社区插件菜单中搜索,会找到两个插件。在这篇文章中,我们将讨论第一个Pandoc 插件
。其实我尝试过使用《Obsidian Enhancing Export》,第二次搜索的时候,效果并不好。
安装潘多克
Pandoc 插件本身不能工作。该插件使用官方的 Pandoc 库来转换文档。
因此,您需要访问Pandoc官网并下载并安装Pandoc库。
访问 Pandoc 网站。 Pandoc支持Windows、macOS、Linux等多种操作系统安装包。下载并安装。
如果您是Windows用户,我推荐msi格式的安装包。如果你想使用zip格式的便携版本,这不是一个大问题。无论如何,下载并安装或解压缩到合适的位置。
在 Obsidian 中安装和配置 Pandoc 插件
在 Obsidian 的设置中允许使用社区插件,并在社区插件菜单中搜索并安装Pandoc 插件
。并激活它。
Obsidian - 设置 - 社区插件 - Pandoc 插件
安装并激活插件后,下一步是设置插件。可以看到设置中已经添加了Pandoc Plugin项。这里需要设置的部分是导出文件夹
和Pandoc路径
。
Obsidian - 设置 - 社区插件 - Pandoc 插件
设置
导出文件夹
:将 Obsidian Markdown 转换为您想要的文件格式时保存文件的文件夹。Pandoc path
: 这是上面下载并安装的 Pandoc 库的可执行文件路径。- 如果您使用 Windows msi 或 Linux deb 安装 Pandoc,则无需配置它。安装 Pandoc 库时,可执行文件路径会注册到环境变量中,因此 Obsidian 会自动识别 Pandoc 路径。
- 但是,如果您下载并解压了可移植格式的 zip 文件,则必须添加
pandoc.exe
的完整绝对路径或pandoc
的可执行文件路径。假设您处于 Windows 环境中,合适的示例是C:\Data\pandoc-3.1.11.1-windows-x86_64\pandoc-3.1.11.1\pandoc.exe
。
一切完成后,重新启动 Obsidian。
Pandoc 插件的使用
要将 Obsidian Markdown 转换为您想要的文件格式,请按Ctrl + P
打开快速调色板。然后,如果您搜索pandocplugin
并选择所需的文件格式,则会在上面设置的导出文件夹中创建一个文件。
Obsidian - 文章 - Ctrl + P
- 搜索 pandoc 插件
- 选择您想要转换的格式
如果您的帖子没有任何图片,不会有问题,但如果包含图片,您会收到错误消息,提示找不到图片文件
Obsidian - Pandoc 插件 - 发布附加图像文件 - 导出为 Word 文档 (docx)
Pandoc 文件转换错误解决方案
问题的原因是插件没有根据markdown文件的位置找到帖子附加的图像文件。该插件将尝试在 Obsidian Vault 根目录中查找图像文件。所以会出现错误,说没有图像文件。
为了解决这个问题,我尝试在插件设置中的Extra Pandoc arguments
中设置--resource-path
选项,但它不起作用。不幸的是这个错误无法修复。因为该插件已经一年多没有更新并且不再维护了。但绕行确实存在!
解决方案是创建一个仅用于导出目的的新保管库,并在需要文档格式转换时使用它。将 md 和图像文件复制到 Vault 根目录并进行转换。
当然,每次转换文件时将 md 文件和图像文件复制到 Vault 以便导出是很麻烦,但考虑到转换后文件的质量,这可能是值得的麻烦。下面是用Pandoc将md转换为word(docx)的结果。
下面是使用 Pandoc 将 md 转换为 PowerPoint (pptx) 的结果。