clearsmog Multi-Format Translation Workflow
Translate documents between supported formats.
CRITICAL: The source file is the SINGLE SOURCE OF TRUTH.
Supported Translations
| From | To | Method |
|---|---|---|
.typ (Typst) |
.qmd (Quarto) |
Component mapping |
.qmd (Quarto) |
.typ (Typst) |
CSS classes to components |
Note: For Beamer (
.tex) translations, configure at project level. Projects with Beamer support should have their own translate skill with environment mapping tables.
Format Detection
Parse $ARGUMENTS:
- First argument: source file path
- Second argument (optional): target format (
.qmd,.typ) - If no target specified, infer from project context
Typst → Quarto
Component Mapping
| Typst (qk) | Quarto CSS |
|---|---|
#keypoint[...] |
::: {.keybox}\n...\n::: |
#insight[...] |
::: {.highlightbox}\n...\n::: |
#tip[...] |
::: {.methodbox}\n...\n::: |
#note[...] |
::: {.softbox}\n...\n::: |
#warning[...] |
::: {.keybox}\n**Warning:** ...\n::: |
#trap[...] |
::: {.keybox}\n**Common mistake:** ...\n::: |
Citation Mapping
@key→@key(same in Quarto)
Math Mapping
$...$(Typst inline) →$...$(Quarto inline)$ ... $(Typst display) →$$...$$(Quarto display)
Quarto → Typst
Component Mapping
| Quarto CSS | Typst (qk) |
|---|---|
::: {.keybox} |
#keypoint[...] |
::: {.highlightbox} |
#insight[...] |
::: {.methodbox} |
#tip[...] |
::: {.resultbox} |
#keypoint[...] |
::: {.quotebox} |
#quote(attribution: "...")[...] |
::: {.softbox} |
#note[...] |
Math Mapping
$...$→$...$$$...$$→$ ... $(display)
Quality Standards (All Translations)
- Content parity — every idea from source must appear in target
- Environment parity — every box/callout must use the corresponding target element
- Notation consistency — same symbols as source
- No content loss — never summarize or condense
- All citations verified — every reference resolves
- All images referenced — every figure path valid
- Compile successfully — target must build without errors
Post-Translation
Run /qa on the translated file to verify quality.