📝

AC技术与生活 Quarkdown还在把 Markdown 只当作“写 README 的工具”吗

原文链接：https://mp.weixin.qq.com/s/k4g0nmUTLDXNyBdPfUI8iA

AC技术与生活 Quarkdown还在把 Markdown 只当作“写 README 的工具”吗

AC技术与生活

Quarkdown

还在把 Markdown 只当作“写 README 的工具”吗？如果你经常在「论文、书籍、演示文稿、知识库、技术文档、个人网站」之间来回切换，那这个项目很可能会让你眼前一亮：

它的核心定位非常直接——一个拥有“超能力”的 Markdown 排版系统。你写一次内容，就能把同一个项目编译成适合不同场景的输出：可打印书籍、学术论文、知识库、静态网站，甚至交互式幻灯片。

对于创作者、研究者、技术作者和文档团队来说，这种“一份源码，多端输出”的工作流极具吸引力。

一、不是换皮 Markdown，而是能力进化

Quarkdown 并不是简单增强语法，而是在 CommonMark 和 GFM 的基础上，构建了一套更强大的扩展体系。

其中最核心的一点是：

👉 它把“函数”带进了 Markdown

1 2	`.somefunction {arg1} {arg2} Body argument`

这意味着你不再只是写文档，而是在“构建文档”。

项目中提到，Quarkdown 提供了持续扩展的标准库，包括：

布局构建
输入输出（I/O）
数学支持
条件判断
循环

📌 换句话说：

👉 很多原本需要模板引擎或脚本完成的事情，现在可以直接在 Markdown 里实现。

二、函数能力：让文档可复用、可维护

例如自定义函数：

`.function {greet}
    to from:
    **Hello, .to** from .from!

.greet {world} from:{iamgio}`

输出结果：

Hello, world from iamgio!

这种能力在真实项目中非常实用：

重复结构抽象成函数
文档风格统一
减少重复劳动
提升维护效率

📌 特别适合：

课程讲义
产品文档
研究报告
团队知识库

三、多端输出：真正的一次写作，多种结果

Quarkdown 支持多种输出目标：

✔ HTML

Plain：类似 Notion / Obsidian，适合知识管理
Paged：基于 paged.js，适合书籍与论文
Slides：基于 reveal.js，适合演示文稿
Docs：适合 Wiki 和技术文档

✔ PDF

HTML 支持的内容都可以导出为 PDF

✔ Plain Text

✔ 文档类型内嵌定义

`.doctype {plain}
.doctype {paged}
.doctype {slides}
.doctype {docs}`

📌 这点非常关键：

👉 文档类型成为内容的一部分，而不是外部配置

你可以随时切换输出形式，而不需要更换工具链。

四、在 Markdown 与 LaTeX 之间找到平衡

如果你使用过 LaTeX，会很容易理解 Quarkdown 的定位：

LaTeX：强大但复杂
Markdown：简单但能力有限

👉 Quarkdown 想做的是：

既保持 Markdown 的可读性，又提供接近 LaTeX 的控制能力

例如：

`.tableofcontents

# Section

## Subsection

1. **First** item
2. **Second** item

.center
    This text is _centered_.

.row alignment:{spacebetween}
    ![Image 1](img1.png)

    ![Image 2](img2.png)

    ![Image 3](img3.png)`

📌 优势：

结构清晰
语义直观
减少复杂命令

五、开发体验：现代文档工具该有的样子

Quarkdown 在体验上也做得很完善：

✅ 实时预览
✅ 快速编译
✅ VS Code 扩展支持

📌 带来的提升：

👉 写作时即时反馈，不需要频繁导出检查

六、安装与环境要求

✔ Linux / macOS

1	`curl -fsSL https://raw.githubusercontent.com/quarkdown-labs/get-quarkdown/refs/heads/main/install.sh \| sudo env "PATH=$PATH" bash`

或使用 Homebrew：

1	`brew install quarkdown-labs/quarkdown/quarkdown`

✔ Windows

1	`irm https://raw.githubusercontent.com/quarkdown-labs/get-quarkdown/refs/heads/main/install.ps1 \| iex`

或使用 Scoop：

1
2
3

`scoop bucket add java
scoop bucket add quarkdown https://github.com/quarkdown-labs/scoop-quarkdown
scoop install quarkdown`

✔ 环境要求

Java 17+
若导出 PDF：需要 Node.js、npm、Puppeteer

七、快速开始：从创建到编译

✔ 创建项目

1	`quarkdown create [directory]`

✔ 编译文档

1	`quarkdown c file.qd`

✔ 推荐开发模式

1	`quarkdown c file.qd -p -w`

📌 效果：

👉 自动编译 + 实时预览

✔ 交互模式

1	`quarkdown repl`

适合学习语法与测试功能。

八、示例项目：Mock Document

Quarkdown 提供了一个完整示例：Mock document

运行方式：

1	`quarkdown c mock/main.qd -p`

📌 价值：

展示真实文档结构
演示完整能力
适合评估项目

九、适合哪些人？

Quarkdown 特别适合：

想要 Markdown 简洁体验，但需要更强能力的人
同时输出论文、书籍、网站、幻灯片的创作者
需要文档工程化的团队
想替代 LaTeX 的用户

十、核心价值总结

👉 Quarkdown 的本质是：

把文档写作升级为“可编排、可复用、可扩展的内容工程”

它不仅仅是 Markdown 工具，而是：

文档编程语言
内容构建系统
多端输出引擎

十一、同类项目对比

1️⃣ LaTeX

学术排版经典
控制力强
学习成本高

2️⃣ Typst

现代排版工具
更好的语法体验
LaTeX 替代方案

3️⃣ AsciiDoc

强结构化文档
适合技术文档

4️⃣ MDX

Markdown + JSX
适合前端内容

5️⃣ Quarkdown

Markdown 风格语法
支持函数与逻辑
多目标输出
文档类型内嵌

参考地址：

• https://github.com/iamgio/quarkdown

``

📣 记得点赞、分享，Thx 🌐
记得按时休息
📚 欢迎关注我的公众号“AC技术与生活”，原创技术文章第一时间推送。

💬 本文评论区已开启，但暂无读者留言。

本文转载自微信公众号，如有侵权请联系删除。

Quarkdown：一次写作，多端输出，让 Markdown 拥有“超能力”