Quarto Files
Write pages as .qmd and reuse existing Quarto sources.
Quarto Files
Any page can be a Quarto file — give it a .qmd extension and it is parsed as
Markdown with the Quarto extensions enabled. Teams already writing Quarto can
reuse their sources without a separate publishing pipeline.
Frontmatter
Standard frontmatter keys (title, description, date, …) work as in .md
files. Quarto-only keys that have no meaning here — format: and execute: —
are stripped automatically, so a .qmd written for the Quarto CLI renders
cleanly without edits.
---
title: My Analysis
format: # ignored by docyard (Quarto CLI option)
html:
toc: true
execute: # ignored by docyard (no code execution)
echo: false
---
What works in .qmd
| Feature | Status |
|---|---|
| Markdown + MDC components | ✅ identical to .md |
| Citations | ✅ @key, [@a; @b] |
| Callouts | ✅ five types, titles, collapse |
| Cross-references | ✅ figures, tables, equations |
Math ($…$, $$…$$) | ✅ KaTeX |
Code cells ({python} etc.) | ⚠️ rendered as code blocks, not executed |
@sec- / @lst- references | ❌ not yet supported |
Note
The Quarto syntax extensions are not exclusive to .qmd — they work in .md
files too. Use .qmd when you want editors and tooling to treat the file as
Quarto, or when migrating an existing Quarto project.