Skip to content

Ox Content 3.0 Roadmap#

View Markdown

Tracking issue: #699.

3.0 is the release that graduates experimental surfaces and accepts the highlighting breaking change. New Markdown and extra chrome stay opt-in. Work lands in small conventional PRs with failing tests first.

Pillar Issue Notes
Stable theme packages #700 Skins and color schemes become an official contract
Complete MDX support #701 JSX, imports, markdown-in-JSX; islands stay JS-free by default
Code Play #648 Linked pillar; see the Code Play Roadmap
Built-in docs-site features #650 Authoring, site outputs, theme chrome — default OFF
Tree-sitter highlighting #702 Landed in #710; highlight: true is native only

Also tracked elsewhere and not duplicated here:

  • i18n / MF2 core: #451

Breaking changes#

  • highlightTheme and highlightLangs go away. There is one highlighter.
  • Languages with no tree-sitter grammar stay plain.
  • Theme package peer ranges move to 3.x.
  • Built-ins and Code Play do not turn on just because the major version changed. Each still needs an explicit install or option.
  • redirects.netlify is removed. Use provider: "netlify" or omit provider so CI can detect Netlify / Cloudflare.

Syntax token CSS uses --octc-syntax-* custom properties on <pre class="ox-highlight css-variables">. Color packages define the matching syntax-* tokens.

Built-ins#

The feature list lives on the Docs Site Feature Roadmap and in #650.

Last updated: