quarkdown
Write and edit Quarkdown documents, an extended form of Markdown, to produce reports, articles, slides, and other formatted content. Add layouts, math, diagrams, and themes, then compile the source to check for errors.
中文简介正在准备中。当前显示英语简介。
原文查看原文说明
Author Quarkdown (.qd) documents, a Markdown-superset typesetting language that compiles to HTML, PDF, or plaintext. Use when the user wants to write or edit .qd files, produce typeset output (articles, reports, slides, books, wikis, notes, static sites) beyond what plain Markdown offers, or share structured plans in a presentation-ready format. Quarkdown adds function calls (`.func {arg}`), variables, layouts, math, diagrams, and document types (plain/paged/slides/docs).
适用场景
- Creating a report with math and diagrams
- Turning a plan into shareable slides
- Writing paged articles or books
- Editing a themed wiki or static site
包含的文件（1）
- SKILL.md2.8 KB
SKILL.md（原文）
安装前可以查看交给 AI 代理的指令内容。
Quarkdown
Quarkdown is a Markdown flavor and typesetting system. It compiles .qd source files to HTML, PDF, or plaintext, extending CommonMark/GFM with function calls, variables, layouts, math, custom themes, and document types. Think of it as a more readable LaTeX.
When to use
Use this skill when the user wants to write or edit a .qd file, or asks for typeset output (PDF, slides, paged article, themed wiki) instead of plain Markdown. Also when they want a polished, shareable version of a plan or report.
Do not use it when plain Markdown is the final target (chat, READMEs, GitHub issues).
New projects
If the user wants to start a new Quarkdown project, tell them to run quarkdown create [dir] themselves. It's an interactive wizard that prompts for values. Don't scaffold project files by hand.
Locating the bundled docs
Quarkdown ships a full offline copy of its wiki and stdlib API reference. Resolve the install dir once:
QUARKDOWN_INSTALL="$(quarkdown doctor get install-dir)"
Resources under $QUARKDOWN_INSTALL:
docs/wiki/_nav.qd: wiki index. Start here to find pages by topic.docs/wiki/*.qd: individual wiki pages.docs/wiki/quickstart.qd: read this first if you are new to Quarkdown.docs/quarkdown-stdlib/: stdlib API reference (function signatures, parameters, return types) as HTML.
Read the relevant wiki pages before writing anything non-trivial.
Workflow
- Locate the install dir (snippet above).
- Read
docs/wiki/_nav.qd, thendocs/wiki/quickstart.qdif you don't know the syntax yet. - Read the specific wiki pages relevant to the task, and stdlib API pages under
docs/when you need exact function signatures. - Write the
.qdfile. - Compile to verify:
quarkdown c <main>.qd --strict --out /tmp/quarkdown-verify.<main>is usuallymain.qdbut confirm against the project.--strictsurfaces errors;--out /tmp/quarkdown-verifykeeps build artifacts out of the user's project (otherwise output lands in./quarkdown-outputrelative to your CWD).- PDF export (
--pdf) is slower because it spins up a headless browser. Only use it when the user asks for a PDF. - Never run live preview (
-p,-w) yourself; it starts a long-running web server. Suggest the command to the user instead.
- PDF export (
- Report any compile errors back to the user.
评价
还没有评价。欢迎分享你的使用感受。
评论
无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。
还没有评论。来写第一条吧。