前言¶
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 图表与数学公式无法渲染的痛点，通过插件化方式接管渲染管线，实现了所见即所得的离线文档体验。项目地址见下方链接。
