Skip to content

docs(kb): why comark#138

Open
larbish wants to merge 2 commits intomainfrom
docs/why-comark
Open

docs(kb): why comark#138
larbish wants to merge 2 commits intomainfrom
docs/why-comark

Conversation

@larbish
Copy link
Copy Markdown
Contributor

@larbish larbish commented Apr 20, 2026

No description provided.

@larbish larbish requested review from atinux and farnabaz April 20, 2026 15:41
@vercel
Copy link
Copy Markdown

vercel bot commented Apr 20, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
comark Ready Ready Preview Apr 21, 2026 8:07am
comark-json-render Ready Ready Preview Apr 21, 2026 8:07am
comark-nextjs Ready Ready Preview Apr 21, 2026 8:07am
comark-nuxt Ready Ready Preview Apr 21, 2026 8:07am
comark-svelte Ready Ready Preview Apr 21, 2026 8:07am
comark-twoslash Ready Ready Preview Apr 21, 2026 8:07am
comark-vue Ready Ready Preview Apr 21, 2026 8:07am

@pkg-pr-new
Copy link
Copy Markdown

pkg-pr-new bot commented Apr 20, 2026

Open in StackBlitz

comark

npm i https://pkg.pr.new/comarkdown/comark@138

@comark/ansi

npm i https://pkg.pr.new/comarkdown/comark/@comark/ansi@138

@comark/html

npm i https://pkg.pr.new/comarkdown/comark/@comark/html@138

@comark/nuxt

npm i https://pkg.pr.new/comarkdown/comark/@comark/nuxt@138

@comark/react

npm i https://pkg.pr.new/comarkdown/comark/@comark/react@138

@comark/svelte

npm i https://pkg.pr.new/comarkdown/comark/@comark/svelte@138

@comark/vue

npm i https://pkg.pr.new/comarkdown/comark/@comark/vue@138

commit: d3217e7

Comment thread docs/content/7.kb/0.why-comark.md Outdated
navigation:
title: Why Markdown?
seo:
title: Why Markdown is the Future of UI Authoring
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
title: Why Markdown is the Future of UI Authoring
title: Why Comark is the Future of UI Authoring

title: Why Comark is the Future of UI Authoring
description: Markdown has become the shared language between humans and AI. Comark extends it all the way to interactive UI.
navigation:
title: Why Markdown?
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
title: Why Markdown?
title: Why Comark?

Comment on lines +103 to +118
Raw HTML does break down at one point: **slots** (named regions inside a component). In HTML syntax, nesting code fences or inner Markdown blocks inside a tag is awkward at best. In Comark, slots are first-class: inner `::` blocks are full Markdown throughout:

````mdc
::tabs
::tab-item{label="Vue"}
```bash
pnpm add @comark/vue
```
::
::tab-item{label="React"}
```bash
pnpm add @comark/react
```
::
::
````
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't believe this is the right example for showcasing the power of the #slot syntax here

- [`<Comark>` in Vue](/rendering/vue) — async components, streaming, slot-based composition
- [`<Comark>` in React](/rendering/react) — Server Components and client-side rendering
- [`<Comark>` in Nuxt](/rendering/nuxt) — zero-config module with auto-imports and Nuxt UI integration
- [`<Comark>` in Svelte 5](/rendering/svelte) — snippets and streaming
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- [`<Comark>` in Svelte 5](/rendering/svelte) — snippets and streaming
- [`<Comark>` in Svelte](/rendering/svelte) — snippets and streaming

@atinux
Copy link
Copy Markdown
Contributor

atinux commented Apr 20, 2026

Left some comments, this is a good start and I like that it is within the Knowledge base, I would add a link to it within the introduction (or with a callout) around here:

CleanShot 2026-04-20 at 18 12 22@2x

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants