org-roam 是面向 emacs 的纯文本个人知识管理系统。ox-hugo 是一个 Org 导出器后端,可将 org-mode 文件导出为兼容 Hugo 的 Markdown 格式。

由于 ox-hugo 生成的 Markdown 并非纯 Markdown 而是 Hugo 专用格式,我们需要对其进行转换以适配 Quartz。这一转换由 OxHugoFlavoredMarkdown 插件实现。虽然该插件是专门为 ox-hugo 设计的,但它应该适用于所有 Hugo 专用的 Markdown 格式。

quartz.config.ts
plugins: {
  transformers: [
    Plugin.FrontMatter({ delims: "+++", language: "toml" }), // if toml frontmatter
    // ...
    Plugin.OxHugoFlavouredMarkdown(),
    Plugin.GitHubFlavoredMarkdown(),
    // ...
  ],
},

使用说明

默认情况下,Quartz 无法直接解析 org-roam 文件,因为其并非 Markdown 格式。您需要使用类似 ox-hugo 的外部工具将 org-roam 文件导出为 Markdown 格式并推送至 Quartz,同时需自行管理静态资源以确保最终输出中包含这些内容。

配置选项

该功能由 OxHugoFlavoredMarkdown 插件提供。如需自定义设置,请参阅该插件的说明文档。