myst-to-quarto

Convert MyST Markdown documents to Quarto syntax including citations, callouts, and figures.

Updated Sep 11, 2026
One-click install
npx skills add https://github.com/cameronbracken/waterology-research --skill myst-to-quarto-cameronbracken
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: myst-to-quarto
Source: https://github.com/cameronbracken/waterology-research/tree/main/skills/myst-to-quarto
Command: npx skills add https://github.com/cameronbracken/waterology-research --skill myst-to-quarto-cameronbracken

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Moving articles, notes, or tutorials written in MyST Markdown into a Quarto project requires manually rewriting citation roles, cross references, directives, and executable code fences, which is error-prone and tedious. ## Core Features & Use Cases - Deterministic Conversion Script: Converts MyST citation roles, cross references, note and warning directives, figure directives, and executable language fences while preserving front matter and ordinary Markdown. - Guided Post-Conversion Review: Walks through verifying citation keys against the bibliography, checking figure paths and captions, and adding Quarto format settings before rendering. - Safe File Handling: Never deletes the source file, refuses an output path equal to the input, and requires --force to overwrite existing output. - Use Case: You have a MyST-based tutorial with citations and figures and need it as a .qmd file in a Quarto website project; run the converter, then verify references and render in the project environment. ## Quick Start Convert the attached MyST file tutorial.md to Quarto syntax and save it as tutorial.qmd, then verify the citations and figures.

Frequently Asked Questions about myst-to-quarto

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

FAQPage Schema
How do I convert MyST Markdown to Quarto?▼

Run the included myst_to_quarto.py script with the input .md file and an output .qmd path. It converts citation roles, cross references, callout directives, figure directives, and executable fences, then you verify citations and render the result.

What MyST syntax does the converter handle?▼

The converter handles cite roles (including parenthetical and year variants), ref and numref roles, note/tip/warning/caution/important directives as Quarto callouts, figure directives with captions and attributes, and executable language fences.

Does the MyST to Quarto conversion overwrite my source file?▼

No, the converter never deletes the source and refuses to run if the output path equals the input path. If the output file already exists, you must pass --force to replace it.

Why do some MyST directives not convert to Quarto?▼

Only citations, cross references, callouts, and figures have explicit conversion rules; other directives are passed through unchanged. After conversion, compare source and output side by side and record unsupported directives for manual handling.

What dependencies are needed to run the MyST converter?▼

The script uses only the Python 3 standard library (argparse, re, pathlib), so no external packages need to be installed. You still need a Quarto project environment to render and inspect the converted output.