Changelog

What changed, and when.

Every released version of the offset-headings extension, and what each one changed.

0

fix: Raise quarto-required to >=1.9.38. The extension manifest registers the filter at pre-ast, and the _extension.yml schema only accepts a filter entry point from that version; below it the render fails validation.

docs: Add a documentation website under docs/, built on the atelier project type and published to https://m.canouil.dev/quarto-offset-headings/.
docs: Trim README.md to a landing page pointing at the website, and example.qmd to a short starting point to copy.
docs: Add the Pages workflow, which renders docs/ on pull requests and deploys it from the release tag.
docs: Add the Quarto Extensions Updates workflow, scanning docs for the website’s own dependencies.

feat!: Remove the quarto-shift option and the compensation for Quarto’s automatic shift-heading-level-by: -1. The compensation could not detect an explicit shift-heading-level-by and silently produced wrong levels when one was set. The filter now only warns when Quarto’s automatic shift can apply, recommending shift-heading-level-by: 0 in the front matter, which disables the shift at the source.

feat: Add the quarto-shift-warning option (default true) to silence the automatic heading shift warning once shift-heading-level-by: 0 is set explicitly, since an explicit shift-heading-level-by is invisible to Lua filters.

docs: Rewrite the automatic heading shift section around the explicit shift-heading-level-by: 0 fix.
docs: Set shift-heading-level-by: 0 in the Typst format of both example fixtures.

feat: Add the quarto-shift option to state or disable the shift-heading-level-by Quarto applies after the filter runs.

fix: Compensate for the shift-heading-level-by: -1 Quarto applies to Typst and PDF/LaTeX output when a document has no level-1 heading, so heading levels match across formats. Previously a heading left at level 1 was destroyed by that shift: the first one replaced the document title and the others became plain paragraphs.

docs: Document the interaction with Quarto’s automatic heading shift, including the AsciiDoc book and explicit shift-heading-level-by limitations.

fix: move lua filter to pre-ast to ensure it runs before any filters (e.g., cascade).

fix: Warn and clamp when max-level (document option or per-heading attribute) is outside the global heading range [1, 6] instead of silently clamping.

docs: State explicit cross-format support (HTML, PDF/LaTeX, Typst, DOCX).
docs: Document the combine rule: document-level offset and per-heading offsets always add together before clamping.
docs: Clarify that max-level caps the combined level (original level + document offset + per-heading or cascade offset), not the per-heading offset on its own.
docs: Add a worked example combining cascade, max-level, and depth on a single heading.
docs: Add example-combine.qmd fixture exercising the combine rules, cap, and depth.

feat: Add offset-headings-max-level attribute and extensions.offset-headings.max-level option to cap how deep a positive offset may push a heading.
feat: Add offset-headings-depth attribute and extensions.offset-headings.depth option to bound how many descendant levels inherit a cascading offset.