前言¶
DeepSeek Harness 的右側文件預覽支持 Markdown 文檔，但 Mermaid 圖表通常僅顯示爲源碼，需要切窗口或依賴外部服務。Markdown Studio 接管 DSH 原生預覽的渲染器，將 Markdown、Mermaid 圖表、KaTeX 公式與代碼高亮集成在同一渲染管線中，且渲染引擎隨包內置，斷網可用。
這是什麼¶
Markdown Studio 是 DeepSeek Harness 的客戶端插件，由 BioAIEvolu 維護。它作爲 DSH 原生文檔預覽的擴展插槽，內置完整的 Markdown、Mermaid、KaTeX 與代碼高亮渲染引擎，實現文檔與圖表的完全離線渲染。
核心功能¶
- 對話內 + 文檔預覽雙渲染：聊天消息裏的 Mermaid 塊與右側打開的 Markdown 文檔，用同一套管線就地渲染成 SVG 圖。
- Mermaid 圖表：支持流程圖、時序圖、甘特圖、餅圖等 Mermaid 11 全系圖型；每張圖帶圖形/源碼/全屏/下載 SVG 工具欄；深淺主題自動重繪。
- 語法自動修復：自動處理如
W2[Codex / Claude Code (ACP)]含英文括號的標籤語法錯誤。 - KaTeX 數學公式：支持行內
$...$與塊級$$...$$渲染。 - 完整 GFM：支持表格、任務列表、腳註、刪除線、標題錨點。
- 代碼高亮：集成 highlight.js。
- 本地圖片：支持相對路徑解析。
- 安全與離線：DOMPurify 淨化 HTML 與 SVG，禁執行腳本；渲染引擎隨包內置，完全離線可用。
安裝與啓用¶
前置條件：DeepSeek Harness 版本需在 0.2.0-rc.2 或更高。
安裝命令：
dsh plugin --profile desktop add github:BioAIEvolu/dsh-md-studio
安裝後重啓 DSH Desktop，在右側打開任意 .md 文件即可啓用。
典型用法¶
- 查看源碼/渲染切換：打開 Markdown 文件後，文檔頂部會出現 Markdown Studio 標識與查看源碼按鈕，用於在源碼與渲染視圖間切換。
- Mermaid 圖表操作：每個 Mermaid 圖表自帶工具欄，支持圖形/源碼切換、全屏（支持滾輪縮放與拖拽平移）、下載 SVG。
- 停用恢復：在插件管理中停用插件，即可恢復 DeepSeek Harness 官方渲染器。
適用場景與注意¶
適用場景：需要頻繁查看 Mermaid 架構圖、時序圖、甘特圖，或需要渲染 KaTeX 數學公式、GFM 表格與腳註的開發者。
限制與注意：
- 依賴 DSH
0.2.0-rc.2及以上版本。 - 文檔上限 200 萬字符，單圖限制 5 萬字符 / 2000 行 / 2000 邊。
- 安全機制：Mermaid 輸出經淨化，禁用交互點擊與外部圖片引用；腳本不執行。
- 插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證。
結尾¶
Markdown Studio 解決了 DeepSeek Harness 原生預覽中 Mermaid 圖表與數學公式無法渲染的痛點，通過插件化方式接管渲染管線，實現了所見即所得的離線文檔體驗。項目地址見下方鏈接。
