2026.09.30
Quarkdown：用可编程 Markdown 统一制作文档、书籍与演示
Quarkdown 面向希望以 Markdown 编写、又需要排版控制和多格式输出的用户。它支持脚本化内容、实时预览及 HTML、PDF 等目标，但采用前应核对版本、浏览器依赖和 GPL-3.0 许可要求。
项目用途
Quarkdown 是一个基于 Markdown 的排版系统，目标是让同一份源内容覆盖多种文档场景：书籍、学术论文、知识库、技术文档和交互式演示。它不是只增加少量 Markdown 语法，而是在 CommonMark 与 GFM 基础上引入了可编程扩展，因此更适合需要重复内容、条件逻辑或自定义布局的长期文档项目。
图片来源：quarkdown。项目公开截图，界面可能随版本变化。
已知功能
Quarkdown Flavor 支持函数、变量、条件语句和循环，也允许用户定义函数与变量。项目 README 还列出布局构建、输入输出和数学相关的标准库能力。对团队而言，这意味着目录、组件或重复段落可以抽象后复用；但它也意味着使用者需要学习 Quarkdown 自己的语法，而不只是普通 Markdown。
输出方面，README 列出 HTML、PDF、GFM Markdown 和纯文本目标。HTML 文档可选择 plain、paged、slides 或 docs 类型，分别适用于连续流页面、分页文档、演示文稿以及文档或知识库场景。项目还提供实时预览、文件变更监视和 REPL 等工作流能力，并有 VS Code 扩展；README 标注的 IntelliJ IDEA 插件则是非官方项目。
图片来源：quarkdown。项目公开截图，界面可能随版本变化。
适合谁
它适合已经熟悉 Markdown、但又需要书籍或论文级排版、静态网站、内部文档或演示输出的人。研究者可以把论文内容与可复用组件放在同一源码体系中；技术写作者和个人知识库维护者则可能受益于单一来源、多目标发布。若团队只需要简单 README，或者希望完全依赖成熟的传统排版生态，是否采用应通过小型原型验证，而不应仅凭项目定位决定。
采用前的限制
首先，README 没有提供最低硬件配置，也没有在所给资料中确认所有操作系统、浏览器版本或大型项目的资源表现，部署前应自行验证。PDF 导出需要 Chromium 系浏览器，这会增加构建环境的依赖；CI 或容器环境尤其要确认浏览器安装、字体和分页结果。
其次，Quarkdown 使用 GPL-3.0。将其纳入工具链、分发修改版本或与其他组件组合时，应让维护者审查许可证义务。项目页面还把“安全默认”描述为限制系统资源的权限机制，但这不是对任何部署场景的安全保证。
最后，版本差异需要纳入发布流程。v2.6.2 的正式 release 修复了浏览器端空代码块问题，并针对 live preview 端点的潜在路径遍历风险加入防护；这说明升级与回归测试仍然重要，尤其是开启实时预览并暴露开发服务时。
部署建议
可先从一份小型论文、文档站或演示稿开始，分别测试 plain、paged、slides 和 docs 输出。将 Quarkdown 版本、Chromium、字体及输出工件固定在 CI 中，并把 live preview 限制在开发环境。对于需要长期维护的团队，还应评估自定义函数的可读性、构建失败时的诊断体验，以及 GPL-3.0 对发布流程的影响。
资料来源
资料核对日期：2026-09-30