[github-actions]

v0.3.0 is the next major release.

Timetable: to be announced.

👉 Changelog

compare changes

🚀 Enhancements

• 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

• 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

• 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

• 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)

🎨 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 ↗	b4ec06e	2026-10-21T11:45:15.302Z	Visit the dashboard ↗
Build: Success ✅ View logs ↗	No Preview URL. Enable ↗	3057851	2026-10-21T11:22:38.091Z	Visit the dashboard ↗
Build: Success ✅ View logs ↗	No Preview URL. Enable ↗	b611294	2026-10-21T10:46:43.858Z	Visit the dashboard ↗
Build: Success ✅ View logs ↗	No Preview URL. Enable ↗	a9b3241	2026-10-21T08:26:28.231Z	Visit the dashboard ↗
Build: Success ✅ View logs ↗	No Preview URL. Enable ↗	db87572	2026-10-21T05:52:59.692Z	Visit the dashboard ↗
Build: Success ✅ View logs ↗	No Preview URL. Enable ↗	8dcf95f	2026-10-20T18:34:37.873Z	Visit the dashboard ↗
Build: Success ✅ View logs ↗	No Preview URL. Enable ↗	c17af16	2026-10-20T17:44:18.430Z	Visit the dashboard ↗
Build: Success ✅ View logs ↗	No Preview URL. Enable ↗	82759e5	2026-10-20T17:33:02.806Z	Visit the dashboard ↗
Build: Success ✅ View logs ↗	No Preview URL. Enable ↗	0aac7ec	2026-10-20T17:10:15.898Z	Visit the dashboard ↗
Build: Success ✅ View logs ↗	No Preview URL. Enable ↗	fcfaefc	2026-10-20T14:38:50.741Z	Visit the dashboard ↗

View all previews: View all previews ↗