Skip to content

docs: Document syntax-highlighting option replacing highlight-style#1873

Closed
cderv wants to merge 7 commits intoquarto-dev:prereleasefrom
cderv:syntax-highlighting-update
Closed

docs: Document syntax-highlighting option replacing highlight-style#1873
cderv wants to merge 7 commits intoquarto-dev:prereleasefrom
cderv:syntax-highlighting-update

Conversation

@cderv
Copy link
Collaborator

@cderv cderv commented Feb 6, 2026

Quarto 1.9 (via Pandoc 3.8) introduces the syntax-highlighting option replacing highlight-style (quarto-dev/quarto-cli#13984). This updates documentation site-wide.

Changes

Site-wide rename of highlight-style to syntax-highlighting in YAML examples and prose across 13 files (tutorials, format pages, book output).

Shared include (_document-options-syntax-highlighting.md):

  • Documents none and idiomatic special values
  • Uses when-meta conditionals for format-specific content (PDF/LaTeX explains listings package, Typst explains native highlighting delegation)
  • Adds a11y to the theme list (was missing)

Format-specific pages:

  • pdf-basics.qmd and typst.qmd set doc-type metadata to trigger conditional content from the shared include
  • typst.qmd now uses _document-options-begin.md (Typst-specific content for TOC, section numbering, and syntax highlighting moved into shared includes via when-meta conditionals)
  • html-code.qmd fixes deprecated fig.alt attribute syntax to fig-alt
  • revealjs/index.qmd adds a ### Syntax Highlighting subsection noting idiomatic is not supported

Historical files (changelog, _draft/) are intentionally unchanged.

Companion to quarto-dev/quarto-cli#13984

@cderv cderv closed this Feb 6, 2026
@cderv cderv deleted the syntax-highlighting-update branch February 6, 2026 14:21
@cderv
Copy link
Collaborator Author

cderv commented Feb 6, 2026

Wrong branch so I reopened #1874

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant