Reference

Syntax matrix

How Comark syntax maps to comark-pdf and jasy PDF primitives.

Status: yes mapped · fallback still a valid PDF · workaround host-side until jasy grows the primitive · host renderPdf option, not markdown · no not mapped · jasy use @jasy/pdf (or a custom component) directly.

Comark syntax → PDF

FeatureComarkcomark-pdfjasy
Frontmatter / pdf:YAMLMerged into page configPage / Document props
Headings h1–h6yesText + Bookmark + Anchor (outline)Bookmark, Anchor, Text
ParagraphyesParagraphParagraph / Text
Bold / italic / strike** _ ~~span flagsspan({ bold, italic, strikethrough })
Inline code`span Courierspan({ font: 'Courier' })
sup / subHTMLspan({ verticalAlign })span({ verticalAlign: 'super' | 'sub' })
Link[text](url)span({ href })span({ href }) / Link
Unordered / ordered listyesRow marker + ColumnRow, Column, Text
Nested listyesRecursive list mapsame primitives
GFM task list- [x] / - [ ]Printed [x] / [ ] (Courier). Drops input. Does not create AcroForm.Text. Checkbox is a form field — not used here.
Blockquote>Tinted Box (+ bar when visuals.quote)Box
Horizontal rule---DividerDivider
GFM tableyesTableTable
Key-value table2-col empty headervisuals.table.keyValue → auto / 2frTable({ columns })
Fenced codeyesMonospace Box. Token color: → span when rangi / Shiki rewrote preColored span in Text
Image (default)![alt](src)Alt-text—
Image embedsamevisuals.image: 'embed': data URI, path, or HTTP fetch (15 s / 8 MB). Fail → alt-text.Image(path | bytes). No Image(url) yet.
Inline image + embed![alt](src) in a pWorkaround: Column of text + Image + textNeeds an inline-replaced image for in-sentence layout
SVG nodeHTML <svg>Svg(sanitizeSvgLengths(…))Svg
::page-breakcomponentPageBreak() or Box({ breakBefore })PageBreak, breakBefore
Multi-page flowlong ASTOne Page; jasy paginatesAutomatic pagination
Header / footer stringspdf.header / footerCompiled chrome; {{ page }} / {{ totalPages }}Page.header / footer, PageNumber, PageCount
{{ }} / :bindbinding pluginInterpolates data / frontmatter / props— (host data)
::if / ::for / ::includebinding pluginBuilt-in jasy components—
Custom ::tagComark componentcomponents.tag → JasyComponentFnAny jasy element
Math $…$ / $$…$$math pluginOptional mathjax-full → Svg. Else Courier source.Svg
Mermaid fencemermaid pluginOptional mermaid (+ DOM / happy-dom) → Svg. Else source box.Svg
Raw HTML as layoutHTML blocksno — flattened / ignored. jasy is not a CSS engine.no — do not ask for Html()
Page-foot footnotesnot a first-class mapno — needs a jasy page-foot / endnote regionHeader/footer chrome is the wrong tool

Future jasy parity

A native jasy Image(url) (parity with addFontFromUrl) would replace the HTTP fetch workaround. A footnote / endnote page region would enable page-foot notes. They are useful, not blockers.

See Host options for renderer options that are not markdown syntax.

Copyright © 2026