在 Markdown 处理器的生态中，Quarkdown 是一个独特的存在。它采用 Kotlin 开发，提供了一个 Turing-complete 的 Markdown 扩展语言，能够从单一源文件编译为书籍、学术论文、知识库或交互式演示文稿。这种多格式输出能力，结合 Kotlin 语言的现代特性，使其在众多 Markdown 工具中脱颖而出。
Quarkdown 核心定位
Quarkdown 定位为现代 Markdown 排版系统，其设计理念是「从想法到成品」的零摩擦流程。项目基于 CommonMark 和 GFM（GitHub Flavored Markdown）构建，并引入了函数调用、自定义变量等编程特性，使 Markdown 不再仅仅是纯静态的标记语言。用户可以在同一套语法体系中完成学术论文撰写、书籍排版、网站搭建和演示文稿制作，所有这些仅需调整目标输出类型即可实现。
该项目的架构设计体现了 Kotlin 语言的诸多优势。代码库采用 Kotlin 特有的空安全特性、协程支持以及丰富的标准库，使得编译速度快、执行效率高。Kotlin 与 Java 的互操作性也方便了生态集成，例如 PDF 导出依赖 Puppeteer（Node.js 生态）时的无缝衔接。
多格式输出能力
Quarkdown 最显著的技术特征是单一源文件支持多种输出格式。目标类型通过 .doctype 函数在源码中声明，这种设计让文档创作与输出格式解耦。
HTML 输出支持四种模式：plain（普通流式布局，类似 Notion 或 Obsidian，适合静态网站和知识管理）、paged（基于 paged.js 的分页文档，适合论文和书籍）、slides（基于 reveal.js 的交互式演示文稿）、docs（适合维基和技术文档的多页面站点）。例如，声明 .doctype {paged} 即可将同一份 Markdown 源文件编译为适合打印的书籍格式。
PDF 输出则继承 HTML 的所有特性，通过 Puppeteer 将 HTML 转换为 PDF。这意味着用户无需学习 LaTeX 或其他排版语言，即可获得专业级的打印成品。Quarkdown 对比表格显示，它在书籍导出、演示文稿导出和静态站点导出方面的能力均优于 LaTeX（静态站点）和 AsciiDoc（演示文稿），同时保持了 Markdown 的简洁语法。
Turing-complete 扩展机制
Quarkdown 的核心竞争力在于其 Turing-complete 的语言扩展。与传统 Markdown 处理器不同，Quarkdown 允许在 Markdown 中定义函数、变量，并使用条件语句和循环。这种设计借鉴了函数式编程的思想，同时保持了 Markdown 的可读性。
函数调用语法简洁直观：
.somefunction {arg1} {arg2}
Body argument
用户可以定义自己的函数，例如创建问候语生成器：
.function {greet}
to from:
**Hello, .to** from .from!
.greet {world} from:{iamgio}
上述代码渲染结果为「Hello, world from iamgio」。标准库提供了布局构建器、输入输出、数学运算、条件判断和循环等常用功能，涵盖了文档处理的大部分场景。这种脚本化能力使得 Quarkdown 能够处理动态内容和复杂排版逻辑，这是传统 Markdown 工具难以企及的。
与竞品对比来看，LaTeX 支持部分脚本能力但语法复杂；Typst 虽然也支持编程式文档生成，但 Quarkdown 的函数式语法更接近自然语言；MDX 虽然支持 JSX 嵌入，但需要前置的 React 生态知识。Quarkdown 的学习曲线为绿色（低难度），这一点在其文档对比表中明确标注。
安装与命令行使用
Quarkdown 提供多平台安装支持。Linux 和 macOS 用户可通过官方安装脚本一键部署，脚本会自动检测并安装 Java 17、Node.js 和 npm（如缺失）。Homebrew 用户可使用 brew install quarkdown-labs/quarkdown/quarkdown 安装。Windows 用户可使用 PowerShell 安装脚本或 Scoop 包管理器。对于 CI/CD 场景，官方提供了 GitHub Actions 插件 setup-quarkdown，便于自动化文档构建。
运行 quarkdown create [directory] 可启动交互式项目向导，自动生成包含元数据和初始内容的项目结构。编译命令为 quarkdown c file.qd，支持 -p（预览）和 -w（监听文件变化）选项。组合使用 -p -w 可实现实时预览效果。--pdf 参数可直接输出 PDF 文件。
项目依赖 Java 17 及以上版本，若需 PDF 导出功能，还需配置 Node.js、npm 和 Puppeteer 环境。
技术选型考量
在 Kotlin 生态中，Quarkdown 代表了一种将现代编程语言特性融入文档处理思路的实践。其优势在于：Kotlin 的类型安全降低了运行时错误、协程提升了编译性能、丰富的标准库加速了功能迭代。对于已有 Kotlin 技术栈的团队，采用 Quarkdown 可统一语言环境，减少技术栈切换成本。
然而，Quarkdown 也有局限性。作为新兴项目，其插件生态和社区成熟度尚在发展中。GPLv3（核心模块）和 AGPLv3（CLI 和 LSP 模块）的许可证可能对企业级闭源项目构成限制。对于重度依赖 LaTeX 学术排版的国家或机构，Quarkdown 的生态兼容性和模板丰富度仍需时间检验。
如果你正在寻找一个兼顾 Markdown 简洁性和编程语言灵活性的文档生成工具，Quarkdown 值得尝试。其多格式输出能力对于需要同时交付书籍、演示和网站的技术作家或开源项目维护者尤其有价值。
资料来源：GitHub iamgio/quarkdown 官方仓库