skills.rest
nrdxp
nrdxpCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

quarto

Applies formatting, structure, and execution rules for authoring Quarto markdown documents.

10|2|Updated Jan 24, 2026
Search Tags:#documentation#markdown#rendering#pandoc#quarto#cross-reference#qmd
One-click install
npx skills add https://github.com/nrdxp/predicate --skill quarto-nrdxp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: quarto
Source: https://github.com/nrdxp/predicate/tree/main/skills/quarto
Command: npx skills add https://github.com/nrdxp/predicate --skill quarto-nrdxp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing Quarto (.qmd) documents correctly requires knowing dozens of syntax rules — fenced divs, cross-reference prefixes, executable code chunks, and YAML configuration — and mistakes like raw HTML or hardcoded figure numbers break rendering and numbering. ## Core Features & Use Cases - Structural Rules: Enforces Pandoc fenced divs for callouts, multi-column layouts, tabsets, and margin content instead of raw HTML. - Cross-Referencing: Mandates ID prefixes (fig-, tbl-, sec-, eq-) so figures, tables, and sections get automatic numbering and @-style references. - Executable Code & Diagrams: Defines executable code chunks with #| options, native Mermaid diagrams, citations, shortcodes, and multi-format output (HTML, PDF, docx, revealjs). - Use Case: When migrating a plain Markdown report to Quarto, follow the built-in migration checklist to convert blockquotes to callouts, add figure IDs, and set up a _quarto.yml project file. ## Quick Start Convert my Markdown report into a properly structured Quarto document with callouts, numbered figures, and a table of contents.

Frequently Asked Questions about quarto

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add cross-references to figures in Quarto?▼

Add an ID with the fig- prefix to the image, such as ![Caption](img.png){#fig-arch}, then reference it inline with @fig-arch. Quarto handles automatic numbering, so never hardcode figure numbers.

How do I create callout blocks in Quarto markdown?▼

Use fenced divs with callout classes like ::: {.callout-note}, ::: {.callout-warning}, or ::: {.callout-tip}. Add collapse="true" for expandable callouts and a ## heading inside for a custom title.

What is the difference between display and executable code chunks in Quarto?▼

Standard triple-backtick blocks with a language name display static code only. Wrapping the language in curly braces like {python} makes the chunk executable, with #| hash-pipe lines controlling options like echo, eval, and output.

Can Quarto documents render to PDF and Word formats?▼

Yes, Quarto supports html, pdf, docx, revealjs, typst, and book formats via the format key in YAML frontmatter. PDF output requires a LaTeX installation, while typst offers a modern alternative.

Why do underscores in Quarto reference IDs cause problems?▼

Underscores in IDs like {#my_figure} cause issues when rendering to PDF via LaTeX. Use hyphens instead, such as {#my-figure}, to keep cross-references working across all output formats.

How do I migrate a Markdown document to Quarto?▼

Add YAML frontmatter with title and format, convert blockquote notes to callout divs, add fig- IDs to images, replace manual section links with @sec- references, and convert static diagrams to Mermaid blocks.

Related Skills

Explore More Content & Communication Skills→
redpanda-dataredpanda-data
34

writing-shape

Transform raw markdown notes into structured articles through iterative conversational drafting.

Official
Intermediate
pedrohcgspedrohcgs
1.5k

deploy

Render Quarto slides to HTML and sync them to docs for GitHub Pages deployment.

Community
Intermediate
tesseract-rippletesseract-ripple
1

validate-bib

Cross-reference LaTeX citations with bibliography entries to detect missing and unused references.

Community
Advanced
Aki2022Aki2022

quarto-authoring

Author and migrate Quarto documents, websites, books, and presentations using .qmd syntax.

Community
Advanced