[github-actions]

v0.4.0 is the next major release.

Timetable: to be announced.

👉 Changelog

compare changes

🚀 Enhancements

• annotate: margin notes: bottom notes, at and to, curved leaders, a bracket mark, violet by default, and one ink per figure (feat(annotate): margin notes: bottom notes, at and to, curved leaders, a bracket mark, violet by default, and one ink per figure #145)
• tabs: package-manager tabs from one install command (feat(tabs): package-manager tabs from one install command #109)
• media: play videos and audio with controls on the shadcn/ui tokens (feat(media): play videos and audio with controls on the shadcn/ui tokens #148)
• figure: add comark-figure (feat(figure): add comark-figure #118)
• mark: add comark-mark (feat(mark): add comark-mark #113)
• qr: add comark-qr (feat(qr): add comark-qr #135)
• outline: add comark-outline (feat(outline): add comark-outline #125)
• deflist: add comark-deflist (feat(deflist): add comark-deflist #110)
• details: add comark-details (feat(details): add comark-details #127)
• lint: validate links across files, block local and preview URLs, and check URLs on request (feat(lint): validate links across files, block local and preview URLs, and check URLs on request #120)
• file-tree: add comark-file-tree (feat(file-tree): add comark-file-tree #119)
• fields: add comark-fields (feat(fields): add comark-fields #133)
• reading-time: add comark-reading-time (feat(reading-time): add comark-reading-time #136)
• code: line markers, diffs, collapsed ranges, line numbers, and terminal frames (feat(code): line markers, diffs, collapsed ranges, line numbers, and terminal frames #117)
• media: add comark-media (feat(media): add comark-media #108)
• badge: add comark-badge (feat(badge): add comark-badge #129)
• cards: add comark-cards (feat(cards): add comark-cards #131)
• steps: add comark-steps (feat(steps): add comark-steps #112)
• docs: recipes in the playground and on the landing canvas, and an icon card on the landing (feat(docs): recipes in the playground and on the landing canvas, and an icon card on the landing #106)
• chips: show X, Bluesky, YouTube, and GitLab avatars through unavatar.io and keep images on disk between builds (feat(chips): show X, Bluesky, YouTube, and GitLab avatars through unavatar.io and keep images on disk between builds #104)
• docs: fill the landing canvas with every example and turn chart cards through their charts (feat(docs): fill the landing canvas with every example and turn chart cards through their charts #103)
• charts: draw any Vega-Lite chart over the table (feat(charts): draw any Vega-Lite chart over the table #101)
• charts: draw while parsing, and render with Vue, React, and Svelte (feat(charts): draw while parsing, and render with Vue, React, and Svelte #99)
• 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

• docs: calm the landing cards, tidy the switches and list, and show a package's examples in its sidebar (fix(docs): calm the landing cards, tidy the switches and list, and show a package's examples in its sidebar #107)
• chips: draw avatar chips without a pill, and fade favicon chips' tint and ring (fix(chips): draw avatar chips without a pill, and fade favicon chips' tint and ring #149)
• badge: default primary to shadcn's --primary, secondary to the muted text, and error to --destructive (fix(badge): default primary to shadcn's --primary, secondary to the muted text, and error to --destructive #142)
• docs: draw the preset card's border over its divider (fix(docs): draw the preset card's border over its divider #144)
• steps: keep the line between steps on pages that style heading margins (fix(steps): keep the line between steps on pages that style heading margins #140)
• docs: scroll the playground's presets to the one a link opens (fix(docs): scroll the playground's presets to the one a link opens #139)
• docs: jump to the new page's position instead of sliding there (fix(docs): jump to the new page's position instead of sliding there #105)
• charts: draw dumbbell gridlines and tighter rows so the change reads at a glance (fix(charts): draw dumbbell gridlines and tighter rows so the change reads at a glance #97)
• docs: resolve generated landing path from module (docs: a canvas of live plugin demos on the landing page, and a studio that writes, checks, fixes, and renders #87)
• docs: center the landing canvas before its first paint after a client navigation (fix(docs): center the landing canvas before its first paint after a client navigation #100)
• docs: serve the pages build.ts renders, so the Nuxt site has the landing canvas, rail, search, and header again (aaed586)
• docs: serve generated landing body and harden canvas interactions (d8eff8c)
• docs: render fixed hero and reset pooled copy state (4be2e65)
• docs: fetch server island body directly (025115c)
• 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)
• docs: resolve build merge conflict (4d15d0c)
• 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

• a still canvas of every example, open examples in the sidebar, a page per annotate component, and plainer prose (docs: a still canvas of every example, open examples in the sidebar, a page per annotate component, and plainer prose #150)
• charts: add a performance example, page load before and after a fix (docs(charts): add a performance example, page load before and after a fix #147)
• fields: say which margins sit outside the layer's override rule (docs(fields): say which margins sit outside the layer's override rule #146)
• say "Built on Comark" in the footer, without crediting the Comark team for this site (docs: say "Built on Comark" in the footer #102)
• chips: show links as a pull request would cite them, not a credits line (docs(chips): show links as a pull request would cite them #98)
• calm the landing, so the canvas holds still and cards and the studio play on hover (6d87481)
• count the plugins on the banner and Open Graph image instead of naming comark-annotate (96458dd)
• 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)
• one container per canvas card, and a studio made for agents whose document uses five plugins (90b689a)
• a canvas of live plugin demos on the landing page, and a studio that writes, checks, fixes, and renders (37805e6)
• 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)

🎉 New Contributors

• vitehub-bot[bot] (@vitehub-bot[bot])

❤️ Contributors

• Max (@onmax)
• vitehub-bot[bot] (@vitehub-bot[bot])

[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 ↗	647d5bb	2026-10-23T18:17:16.941Z	Visit the dashboard ↗
Build: Success ✅ View logs ↗	No Preview URL. Enable ↗	7877c7c	2026-10-23T16:36:03.932Z	Visit the dashboard ↗
Build: Success ✅ View logs ↗	No Preview URL. Enable ↗	c8c7ec4	2026-10-23T16:02:32.594Z	Visit the dashboard ↗
Build: In progress 🔵 View logs ↗		31f219e	2026-10-23T15:20:33.756Z	View logs ↗
Build: Success ✅ View logs ↗	No Preview URL. Enable ↗	448e41c	2026-10-23T15:03:15.963Z	Visit the dashboard ↗
Build: Success ✅ View logs ↗	No Preview URL. Enable ↗	2101f13	2026-10-23T14:39:54.218Z	Visit the dashboard ↗
Build: Success ✅ View logs ↗	No Preview URL. Enable ↗	74344f5	2026-10-23T14:24:43.243Z	Visit the dashboard ↗
Build: Success ✅ View logs ↗	No Preview URL. Enable ↗	63c1792	2026-10-23T14:04:22.102Z	Visit the dashboard ↗
Build: Success ✅ View logs ↗	No Preview URL. Enable ↗	0a4f7f8	2026-10-23T13:44:20.585Z	Visit the dashboard ↗
Build: Success ✅ View logs ↗	No Preview URL. Enable ↗	084e4fc	2026-10-23T13:28:02.313Z	Visit the dashboard ↗

View all previews: View all previews ↗