Format support

The same JSON aims to look the same in all three formats. Styles a format can’t express are ignored with a warning (once per field), never an error.

Legend: ✓ supported; ✗ ignored with a warning; — ignored silently.

How each format is produced

	docx	pdf	html
Engine	docx-rs	converted to Typst, then compiled	hand-built HTML with its own CSS
Fonts	names only; the reader’s computer supplies them	found on the rendering machine and embedded	left to the browser
Images	packed into the file	packed into the file	local images as `data:` URIs
Page breaks	✓	✓	when printing or with `--paged`
Headers, footers, page numbers	Word fields, computed on open	computed after layout	only with `--paged`

Component	docx	pdf	html
Heading	✓ also gets Word “Heading 1–6”	✓	✓
Text, Code, List	✓	✓	✓
Code `lineNumbers`	✓	✓	✓
Table	✓ part styles written per cell	✓	✓
Image	png, jpeg, gif, webp only	no URLs	✓
PageBreak	✓	✓	when printing or with `--paged`
Section	✓ extra empty paragraph at each section end holds its settings	✓	with `--paged`; printing uses the first section’s paper
Slide	level-2 heading plus content, then a page break; `body` part ✗	one per page	one per page (16:9 box)

Field	docx	pdf	html
`fontFamily` fallback lists	first name only	✓	✓
`italic`	✓	CJK fonts have no italic	✓
`underline` double, wavy	✓	drawn single, ✗	✓
`underlineColor`	✗	✓	✓
`strike: "double"`	✓	drawn single, ✗	✓
`caps: "small"`	✗	✓	✓
`emphasisMark`	✗	✗	✓
`scale`	✓	✗	✗
`kerning`	✗	✓	✓
`lang`	—	✓	✓
color alpha	—	✓	✓

Field	docx	pdf	html
`align: "distribute"`	✓	as `justify`, ✗	✓
`lineHeight: { atLeast }`	✓	✓	as exact
`autoSpace`	✗	✓	✓
`kinsoku`	✗	— on by default	✓
`wrap: false`	✗	✗	✓
`outlineLevel`	✓	—	—
`contextualSpacing`	✗	✗	✗
`borderBetween`	✓	✗	✗

Field	docx	pdf	html
paragraph `padding`	only with a border (the built-in Code style warns for this reason)	✓	✓
`radius`	✗	✓	✓
`background` pattern	✓	blended to solid	blended to solid
`background` gradient	first color	✓	✓
border `dashDot` / `wave`	✓	✓	drawn as dashed / solid
`borderDiagonal`	not implemented	not implemented	not implemented
`textRotation`	table cells only	✓	✓

Field	docx	pdf	html
`listMarkerImage`	✗	✓	✓
`listMarkerGap` as a length	as `tab`, ✗	✓	✓
`tableLayout`	✓	—	✓
`rowBreak: false`	✓	✗	✓
exact row height	✓	✓	as minimum
minimum row height	✓	single-line cells only	✓
repeated header	✓	✓	when printing or with `--paged`
`meta.title` / `author` / `lang`	—	✓	✓

Default CJK fonts are tried in this order: PingFang SC, Hiragino Sans GB, Noto Sans CJK SC, Source Han Sans SC, Microsoft YaHei.
If none is found, Typst’s bundled fonts are used and CJK characters may be missing.
Your own fontFamily goes in front of the default list.

These are on the development branch but not released yet (latest release: v0.1.0-alpha.2):

pdf, html: text ending in a line break gets one more empty line at the end, like Word.
pdf: exact line heights are no longer stretched by the font; changing font size in a cell keeps the line height.
pdf: a cell’s own line height (e.g. the header’s lineHeight) is no longer lost.
pdf: glyphs sit in the line box using the font’s own ascender/descender, no longer riding high.
pdf: space before/after is no longer dropped when the paragraph has left/right indents.
pdf: space before is kept at section starts and after manual page breaks, like Word.
pdf: font weights are normalized per family, so fonts like MiSans with non-round weights bold correctly.
docx: hangingIndent no longer pushes the first line to the left.
docx: the paragraph anchoring an absolutely positioned image no longer takes up a line.
html --paged: the dashed lines and gaps between sections on screen are gone.