본문으로 건너뛰기
cccskills
무료GitHub에 공개

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).

iamgio/quarkdown
설치 방법 보기

이럴 때 유용합니다

  • 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(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

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

  1. Locate the install dir (snippet above).
  2. Read docs/wiki/_nav.qd, then docs/wiki/quickstart.qd if you don't know the syntax yet.
  3. Read the specific wiki pages relevant to the task, and stdlib API pages under docs/ when you need exact function signatures.
  4. Write the .qd file.
  5. Compile to verify: quarkdown c <main>.qd --strict --out /tmp/quarkdown-verify. <main> is usually main.qd but confirm against the project. --strict surfaces errors; --out /tmp/quarkdown-verify keeps build artifacts out of the user's project (otherwise output lands in ./quarkdown-output relative 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.
  6. Report any compile errors back to the user.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

이 스킬의 문제 신고