文章

将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》,第二次搜索的时候,效果并不好。

Obsidian - `社区插件` - `Pandoc 插件` Obsidian - 社区插件 - Pandoc 插件

安装潘多克

Pandoc 插件本身不能工作。该插件使用官方的 Pandoc 库来转换文档。

因此,您需要访问Pandoc官网并下载并安装Pandoc库。

访问 Pandoc 网站。 Pandoc支持Windows、macOS、Linux等多种操作系统安装包。下载并安装。

Pandoc 官方网站 - 下载 Pandoc 官方网站 - 下载

如果您是Windows用户,我推荐msi格式的安装包。如果你想使用zip格式的便携版本,这不是一个大问题。无论如何,下载并安装或解压缩到合适的位置。

在 Obsidian 中安装和配置 Pandoc 插件

在 Obsidian 的设置中允许使用社区插件,并在社区插件菜单中搜索并安装Pandoc 插件。并激活它。

Obsidian - 设置 - 社区插件 - Pandoc 插件 Obsidian - 设置 - 社区插件 - Pandoc 插件

安装并激活插件后,下一步是设置插件。可以看到设置中已经添加了Pandoc Plugin项。这里需要设置的部分是导出文件夹Pandoc路径

Obsidian - 设置 - 社区插件 - `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 - 文章 - Ctrl + P - 搜索 pandoc 插件 - 选择您想要转换的格式

如果您的帖子没有任何图片,不会有问题,但如果包含图片,您会收到错误消息,提示找不到图片文件

Obsidian - Pandoc 插件 - 发布附加图像文件 - 导出为 Word 文档 (docx) Obsidian - Pandoc 插件 - 发布附加图像文件 - 导出为 Word 文档 (docx)

Pandoc 文件转换错误解决方案

问题的原因是插件没有根据markdown文件的位置找到帖子附加的图像文件。该插件将尝试在 Obsidian Vault 根目录中查找图像文件。所以会出现错误,说没有图像文件。

为了解决这个问题,我尝试在插件设置中的Extra Pandoc arguments中设置--resource-path选项,但它不起作用。不幸的是这个错误无法修复。因为该插件已经一年多没有更新并且不再维护了。但绕行确实存在!

解决方案是创建一个仅用于导出目的的新保管库,并在需要文档格式转换时使用它。将 md 和图像文件复制到 Vault 根目录并进行转换。

仅限出口目的的新Obsidian库 仅限出口目的的新Obsidian库

当然,每次转换文件时将 md 文件和图像文件复制到 Vault 以便导出是很麻烦,但考虑到转换后文件的质量,这可能是值得的麻烦。下面是用Pandoc将md转换为word(docx)的结果。

Pandoc 创建的 **Word** 文件 Pandoc 创建的 Word 文件

下面是使用 Pandoc 将 md 转换为 PowerPoint (pptx) 的结果。

**PowerPoint 文件** 由 Pandoc 创建 PowerPoint 文件 由 Pandoc 创建

本文由作者按照 CC BY 4.0 进行授权