comark

Comark 是一個開源的 Markdown 解析器與渲染器,支援元件、屬性與外掛。它將 AI 輸出串流至 React、Vue、Svelte、Angular、HTML 以及

comark 是什麼?

Comark 是一個開源的 Markdown 解析器與渲染器,支援元件、屬性與外掛。它將 AI 輸出串流至 React、Vue、Svelte、Angular、HTML 與終端機。

comark 概覽

這是什麼

Comark 是一個開源的 Markdown 解析器與渲染器,支援元件、屬性與外掛。它能將 AI 輸出串流到 React、Vue、Svelte、Angular、HTML 與終端機。Comark 支援 CommonMark 與 GFM,並在編譯時期、執行時期或串流過程中將其解析為緊湊、可序列化的文件。同一份文件可在不同渲染器中使用,或透過可讀的元件與屬性擴充語法,以呈現更豐富的內容。

主要功能

  • 執行時期解析:parseMarkdown(markdown) 是一個純函式,回傳緊湊、可序列化的 Markdown 文件。來自資料庫、CMS 或 LLM 的內容在儲存後立即生效,無需重建或重新部署。
  • 內建串流:自動補全未閉合的語法(如 **bold、未閉合的程式碼區塊、半開元件),確保 AI 輸出在每一幀都能正確渲染。
  • 單一解析器,多種渲染器:同一份原始碼可渲染為 HTML、ANSI、Vue、React、Svelte 與 Angular。你的內容比框架更長壽。
  • 仍是純 Markdown:支援 CommonMark + GFM(有少許差異)、frontmatter,以及原生元素上的 {.class} 屬性。元件是選擇性語法,而非新語言。
  • 外掛生態系:支援 Shiki 語法高亮、KaTeX 數學公式、Mermaid 圖表、目錄、警示、註腳等,並相容於現有的 markdown-it 外掛。
  • 解析與渲染分離:在伺服器端解析一次,將可序列化的文件(['tag', props, ...children])傳送至客戶端,無需重新解析即可渲染。
  • 快速:基於 markdown-exit(markdown-it 的 TypeScript 重寫版),完整支援 TypeScript。

使用情境

Comark 專為即時渲染 AI 聊天輸出而設計,能在串流過程中正確顯示 Markdown。它也可用於任何需要跨多種框架(React、Vue、Svelte、Angular、HTML、終端機)解析與渲染 Markdown 的應用,例如來自資料庫、CMS 或 LLM 的內容。解析與渲染分離的模式允許在伺服器端解析,在客戶端渲染,無需重新解析。

快速開始

bashnpm install comark``````tsimport { parseMarkdown } from 'comark'const tree = await parseMarkdown('# Hello **World**')// { nodes: [['h1', { id: 'hello' }, 'Hello ', ['strong', {}, 'World']]], frontmatter: {}, meta: {} }接著選擇一個渲染器(例如 Vue、React、Svelte、Angular、HTML),安裝對應的套件(如 @comark/vue、@comark/react、@comark/svelte、@comark/angular、@comark/html)。完整範例請參閱儲存庫的 README。

授權與價格

Comark 採用 MIT 授權條款發布。它是開源且免費使用的。

內容整理自該專案公開的 README 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/comarkdowncomark.svg)](https://yunodb.com/tools/comarkdowncomark?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/comarkdowncomark?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/comarkdowncomark.svg" alt="Featured on YunoDB" height="20"></a>