quarto-authoring

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

Updated Dec 9, 2025
One-click install
npx skills add https://github.com/Aki2022/skills --skill quarto-authoring-aki2022
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: quarto-authoring
Source: https://github.com/Aki2022/skills/tree/main/quarto-authoring
Command: npx skills add https://github.com/Aki2022/skills --skill quarto-authoring-aki2022

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing Quarto documents requires knowing dozens of syntax rules—hashpipe cell options, cross-reference prefixes, callout types, layout classes—and migrating from R Markdown, bookdown, xaringan, distill, blogdown, or Jupyter involves many subtle format changes. This Skill provides the correct syntax and conversion mappings so documents render correctly the first time. ## Core Features & Use Cases - Quarto Authoring Guidance: Covers YAML front matter, code cell options, cross-references, figures, tables, citations, callouts, diagrams (Mermaid/Graphviz), layouts, conditional content, shortcodes, extensions, and compute engines (knitr, jupyter, julia). - Format Migration Guides: Step-by-step conversion references for R Markdown, bookdown, xaringan, distill, blogdown, and Jupyter notebooks, including YAML mapping tables and syntax translations. - Use Case: A data scientist converting a bookdown project to a Quarto book gets exact mappings for _bookdown.yml to _quarto.yml, \@ref() to @ cross-references, and theorem environment syntax. ## Quick Start Use the quarto-authoring skill to create a Quarto HTML report with a cross-referenced figure, a citation, and a collapsible callout block.

Frequently Asked Questions about quarto-authoring

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

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

Assign a label with a type prefix such as fig- or tbl- to the element, then reference it with @label in the text. For code cells use #| label: fig-plot with #| fig-cap, and for markdown tables wrap them in a div with {#tbl-name}.

How to convert an R Markdown document to Quarto?

Rename .Rmd to .qmd, change output: html_document to format: html, and move chunk options into #| hashpipe lines using dashes instead of dots, such as fig-cap instead of fig.cap. Quarto can also render .Rmd files directly for incremental migration.

Does Quarto support caching for Python code cells?

Cell-level cache: true only works for R cells with the knitr engine. For Python and Julia via the jupyter engine, install jupyter-cache and set execute: cache: true in the document YAML front matter.

What is the difference between knitr and jupyter engines in Quarto?

Quarto auto-detects the engine from the first executable cell: {r} selects knitr, {python} selects jupyter, and {julia} selects the julia engine. All hashpipe options and cross-reference syntax are identical, but table rendering and inline code behavior differ between engines.

Why is my Quarto cross-reference not working?

Cross-references fail when the label lacks the correct type prefix such as fig-, tbl-, sec-, or eq-, or when the reference omits the @ symbol. Quarto uses tbl- for tables, not the bookdown-style tab- prefix.

How do I create a Quarto website or blog?

Create a _quarto.yml file with project type website, define navbar entries, and add a listing page pointing to a posts directory for blogs. Posts use standard YAML front matter with title, date, categories, and an optional preview image.