Quarkdown 听名字就很科幻,其实它就是一个基于 Markdown 的超强排版系统。你平时写个 README、写篇博文、做 PPT、甚至想出本书,都能靠它一键搞定——印刷级排版、交互式演示通通支持。它在 CommonMark 和 GFM 的基础上,扩充了一大堆语法,让你直接在 Markdown 里写函数、变量、流程控制,玩到飞起。

为啥要用它?
说实话,咱们写技术文档、学术论文、演示幻灯片,总要在不同工具间切来切去。Word、PowerPoint、Reveal.js、Paged.js……切换一大堆,文档和代码总不在一处,很崩溃。Quarkdown 最大的亮点就是「一套源码,多种输出」:
- 直接输出 HTML、Slides(Reveal.js)、Paged(书籍/文章)
- 一键导出 PDF,特性全量保留
- Turing 完整扩展:自定义函数、变量、条件、循环……
想想能省多少脑细胞!
怎么玩?
真没想象的复杂,先写个 .quarkdown 文件就行。下面直接上代码示例:
// 调用一个布局函数,示例
.
somefunction {arg1}{arg2}
这里是函数体内容,可以是任意Markdown。
// 自定义小函数
.
function{greet}
to from:
**Hello, .to**,来自 .from!
.
greet {世界}from:{iamgio}
// 编译结果:Hello, 世界,来自 iamgio!
配合命令行:
quarkdown build demo.qmd -o demo.html
quarkdown build demo.qmd -p // 输出 paged 文档
quarkdown build demo.qmd -P pdf // 输出 PDF
不够过瘾?跳到 live preview 窗口,改完源文件秒编译,极速反馈,写文档就跟打游戏似的。
优缺点大盘点
| 优点 |
缺点 |
| 一份源码,多端输出 |
学习曲线比普通 Markdown 稍陡 |
| 原生支持函数、变量、流程控制 |
生态相对年轻,第三方插件少 |
| 极速增量编译,实时预览 |
Paged.js 导出需要本地服务器支持 |
| 打印级排版,出版、演示两不误 |
文档示例多,入门需要时间 |
总结
要是你还在 Word、PowerPoint、Typora、Pandoc 里来回迁移,真心可以试试 Quarkdown。它把「一切皆函数」的思路嫁接到 Markdown,给了更多排版和脚本能力,让写文档、做演示、排书籍都统一在一个工具链里。适合文档量大、排版要求高、想要自动化的朋友。
不怕多花点时间学语法,后来就省心了,效率蹭蹭往上涨!
项目地址:https://github.com/iamgio/quarkdown
如果对这类工具感兴趣,云栈社区也收录了该项目的开源实战经验,可供参考。
|