[github-actions]

v0.3.0 is the next major release.

Timetable: to be announced.

👉 Changelog

compare changes

🚀 Enhancements

• code: --ck-title-font for the header's title, and a Theming page for comark-diff (feat(code): --ck-title-font for the header's title, and a Theming page for comark-diff #92)
• code: a header above the code with its file's name and the buttons, and actions with an icon and an onCodeAction() callback (feat(code): a header above the code with its file's name and the buttons, and actions with an icon and an onCodeAction() callback #86)
• diff: move ::diff out of comark-annotate into its own package, comark-diff (feat(diff): move ::diff out of comark-annotate into its own package, comark-diff #73)
• chips: a tinted chip with a hairline ring that stays in the line, --cp-* variables, and a Theming page (feat(chips): a tinted chip with a hairline ring that stays in the line, --cp-* variables, and a Theming page #83)
• charts,embed: a Theming page for annotate, charts, embed, github, and icon, with CSS variables for a chart's side padding and a Short's width (feat(charts,embed): a Theming page for annotate, charts, embed, github, and icon, with CSS variables for a chart's side padding and a Short's width #84)
• tabs: slide the open tab's highlight to the tab you pick (feat(tabs): slide the open tab's highlight to the tab you pick #85)
• CSS variables and a Theming page for zoom, carousel, tabs, and code (feat: CSS variables and a Theming page for zoom, carousel, tabs, and code #81)
• ⚠️ require comark 0.8, whose parser keeps Markdown inside HTML blocks (feat!: require comark 0.8, whose parser keeps Markdown inside HTML blocks #75)
• github: rename comark-github-callouts to comark-github, and add @user and feat(footnotes): add comark-footnotes #123 references and GitHub's HTML allowlist (feat(github): rename comark-github-callouts to comark-github, and add @user and #123 references and GitHub's HTML allowlist #74)
• chips: links and @mentions as chips with the site's favicon or the person's avatar (feat(chips): links and @mentions as chips with the site's favicon or the person's avatar #76)
• annotate: numbers pick a free corner, and marks are bolder, hug their target, and each wobble their own way (feat(annotate): numbers pick a free corner, and marks are bolder, hug their target, and each wobble their own way #66)
• tabs: add an icon prop, drawn by comark-icon from Iconify names or image URLs (feat(tabs): add an icon prop, drawn by comark-icon from Iconify names or image URLs #51)
• icon: add comark-icon, Iconify icons in Markdown drawn as CSS, and a resolver other plugins share (feat(icon): add comark-icon, Iconify icons in Markdown drawn as CSS, and a resolver other plugins share #54)
• code: add comark-code, copy and wrap buttons on code blocks and actions of your own (feat(code): add comark-code, copy and wrap buttons on code blocks and actions of your own #46)
• annotate: handwrite side notes and labels in an inlined Caveat by default (feat(annotate): handwrite side notes and labels in an inlined Caveat by default #57)
• annotate,charts: export the agent skill so apps can bundle it, and have it mark only what changed (feat(annotate,charts): export the agent skill so apps can bundle it, and have it mark only what changed #52)
• charts: add comark-charts, charts drawn from Markdown tables that agents read as data (feat(charts): add comark-charts, charts drawn from Markdown tables that agents read as data #44)
• tabs: add comark-tabs, tabs and code groups that read without a script and sync by label (feat(tabs): add comark-tabs, tabs and code groups that read without a script and sync by label #37)
• lint: add comark-lint, a linter for Comark documents (feat(lint): add comark-lint, a linter for Comark documents #38)
• include: include Markdown partials and code snippets from files (feat(include): include Markdown partials and code snippets from files #34)
• annotate: add ::diff, a code change shown like a suggested change in a review (feat(annotate): add ::diff, a code change shown like a suggested change in a review #39)
• embed: add comark-embed, players for video, audio, and tools from a link (feat(embed): add comark-embed, players for video, audio, and tools from a link #35)
• annotate: copy a screenshot with its marks, and list side notes under compared screenshots (feat(annotate): copy a screenshot with its marks, and list side notes under compared screenshots #26)
• ⚠️ ESM-only exports and a Node >=22.12 engines floor (feat!: ESM-only exports and a Node >=22.12 engines floor #31)
• annotate: a zoomed screenshot shows its notes beside it, and a mark lights up its note there (feat(annotate): a zoomed screenshot shows its notes beside it, and a mark lights up its note there #15)
• github-callouts: GitHub's > [!NOTE] alerts as shadcn-style callouts (feat(github-callouts): GitHub's > [!NOTE] alerts as shadcn-style callouts #23)
• annotate: a slider mode for compare (feat(annotate): a slider mode for compare #17)
• ⚠️ zoom: data-zoom-aside shows a caption beside the zoomed item, and the events map copies to the page and back (feat(zoom): data-zoom-aside shows a caption beside the zoomed item, and the events map copies to the page and back #14)

🩹 Fixes

• charts: marks on their points, every month labeled, notes in their own style, and readable labels on areas (fix(charts): marks on their points, every month labeled, notes in their own style, and readable labels on areas #91)
• annotate,carousel: badges stay on their own mark, and carousel slides align to the top (fix(annotate,carousel): badges stay on their own mark, and carousel slides align to the top #90)
• zoom,tabs: a gap between grouped blocks, centered thumbnails, visible gallery arrows, and a raised selected tab in dark (fix(zoom,tabs): a gap between grouped blocks, centered thumbnails, visible gallery arrows, and a raised selected tab in dark #89)
• chips: name the chip .cp, so a chart on the same page stops drawing as a gray pill (fix(chips): name the chip .cp, so a chart on the same page stops drawing as a gray pill #82)
• drop the stale code page, name the linter's command lint-comark everywhere, lint ::embed, and correct three LICENSE files (fix: drop the stale code page, name the linter's command lint-comark everywhere, lint ::embed, give chips its own class, and correct four LICENSE files #77)
• lint: publish as comark-linter, since npm refuses comark-lint as too close to remark-lint (fix(lint): publish as comark-linter, since npm refuses comark-lint as too close to remark-lint #55)
• lint: know comark-tabs' :::tabs-item and ::code-group, which its renderer has no component for (fix(lint): know comark-tabs' :::tabs-item and ::code-group, which its renderer has no component for #59)
• lint: never throw on odd frontmatter or huge entities, and place and find diagnostics correctly (fix(lint): never throw on odd frontmatter or huge entities, and place and find diagnostics correctly #43)
• annotate: ::diff marks whole characters, keeps highlights, follows a .dark theme, and looks like a shadcn Card (fix(annotate): ::diff marks whole characters, keeps highlights, follows a .dark theme, and looks like a shadcn Card #41)
• annotate: Control+C copies a zoomed screenshot again, and the SVG clone states its safety (fix(annotate): Control+C copies a zoomed screenshot again, and the SVG clone states its safety #33)
• github-callouts: bundle only the theme from comark-zoom, so callouts don't install zoom or ship its styles (fix(github-callouts): bundle only the theme from comark-zoom, so callouts don't install zoom or ship its styles #29)
• annotate: draw lighter marks and keep their numbers off the target (fix(annotate): draw lighter marks and keep their numbers off the target #28)
• zoom: keep ComarkZoomEventMap, which feat(zoom): data-zoom-aside shows a caption beside the zoomed item, and the events map copies to the page and back #14 named for hosts that extend the events (fix(zoom): keep ComarkZoomEventMap, which #14 named for hosts that extend the events #27)
• zoom: the HTML renderer's script shows the aside and maps copies too (fix(zoom): the HTML renderer's script shows the aside and maps copies too #25)
• green CI on main after feat(zoom): data-zoom-aside shows a caption beside the zoomed item, and the events map copies to the page and back #14 and feat(annotate): a slider mode for compare #17 (fix: green CI on main after #14 and #17 #24)

💅 Refactors

• docs: keep each package's pages in its own docs/ folder, like VueUse (refactor(docs): keep each package's pages in its own docs/ folder, like VueUse #79)
• lint: rename comark-lint to lint-comark, since npm blocks a name that close to remark-lint (refactor(lint): rename comark-lint to lint-comark, since npm blocks a name that close to remark-lint #67)

📖 Documentation

• build the site with Nuxt 5 and @vite-hub/content (docs: build the site with Nuxt 5 and @vite-hub/content #45)
• a Theme pane in the playground to try the --comark-* tokens live (docs: a Theme pane in the playground to try the --comark-* tokens live #94)
• embed: a Live code example that runs embedded, and why WebContainer projects need an isolated page (docs(embed): a Live code example that runs embedded, and why WebContainer projects need an isolated page #93)
• clearer example names, marks on what their notes describe, correct numbers, and legible playground cards (docs: clearer example names, marks on what their notes describe, correct numbers, and legible playground cards #88)
• copy and reset in the playground editor's corner, a plain Config pane, and a search box whose icon stays put (docs: copy and reset in the playground editor's corner, a plain Config pane, and a search box whose icon stays put #72)
• silly examples from a made-up correlations app, an Open Graph image, and a README banner (docs: silly examples from a made-up correlations app, an Open Graph image, and a README banner #70)
• lint: a guide for running comark-lint next to ESLint or oxlint, and as part of Vite Doctor (docs(lint): a guide for running comark-lint next to ESLint or oxlint, and as part of Vite Doctor #68)
• credit each package in its own footer, and give the playground a Config tab (docs: credit each package in its own footer, and give the playground a Config tab #61)
• a landing page like vitehub.dev, with a package grid, Drop, a starred GitHub button, and a new logo (docs: a landing page like vitehub.dev, with a package grid, Drop, a starred GitHub button, and a new logo #65)
• code: give comark-code a docs section and put it in the playground (docs(code): give comark-code a docs section and put it in the playground #71)
• name the playground's Config pane as a file (docs: name the playground's Config pane as a file #69)
• a Config tab in the playground, and preset stills that show their whole example (docs: a Config tab in the playground, and preset stills that show their whole example #62)
• add npmx and docs badges to every package README (docs: add npmx and docs badges to every package README #64)
• promote Drop at the bottom of the sidebar (docs: promote Drop at the bottom of the sidebar #63)
• a landing page that types its Markdown, a rail that widens on hover, and a Vite Doctor page (docs: a landing page that types its Markdown, a rail that widens on hover, and a Vite Doctor page #60)
• add a recipe for sharing a review, on Drop or a page you host (docs: add a recipe for sharing a review, on Drop or a page you host #58)
• list comark-charts' skill, and show how an app bundles a skill that matches its renderer (docs: list comark-charts' skill, and show how an app bundles a skill that matches its renderer #53)
• one section per package, with an icon rail and a playground (docs: one section per package, with an icon rail and a playground #50)
• compare comark-charts with comark-vega and comark-flint-chart (docs: compare comark-charts with comark-vega and comark-flint-chart #48)
• group the site into guides, recipes, and package pages (docs: group the site into guides, recipes, and package pages #47)
• github-callouts: say what Comark's built-in alert plugin does and what this package adds (docs(github-callouts): say what Comark's built-in alert plugin does and what this package adds #30)

📦 Build

• share one tsdown preset across packages, and name annotate's browser script script.ts like zoom's (build: share one tsdown preset across packages, and name annotate's browser script script.ts like zoom's #78)

✅ Tests

• check that every package is registered everywhere a new one has to be (test: check that every package is registered everywhere a new one has to be #80)

🎨 Styles

• embed: border the player, add link icons, lay the card out as a shadcn Item, and stop dark iframes flashing white (style(embed): border the player, add link icons, lay the card out as a shadcn Item, and stop dark iframes flashing white #40)

🤖 CI

• release: publish to npm directly instead of staging for approval (ci(release): publish to npm directly instead of staging for approval #42)
• one vp check step, and the tests on Node 22.12 (ci: one vp check step, and the tests on Node 22.12 #32)

❤️ Contributors

• Max (@onmax)

[cloudflare-workers-and-pages]

🚀 Deploying Preview to Cloudflare 🚀

Preview Deployments by commit

Status	Deployment URL	Commit	Updated (UTC)	See this deployment's details
Build: Success ✅ View logs ↗	No Preview URL. Enable ↗	6bcb784	2026-10-22T10:28:03.099Z	Visit the dashboard ↗