前言¶
在 DeepSeek Harness（DSH）里打开工作区里的 .md 文件时，右侧文档预览只能看、不能「带走」：要把同一份内容发给同事、归档成 PDF，往往得另开编辑器或命令行工具，和当前预览所见也不一定一致。社区插件 dsh-markdown-export（维护者 ZhaoChongyan，分类为客户端）把 Export 挂进内置 Markdown 预览工具栏，用与预览相同的数据源渲染，再导出单文件 HTML，或通过浏览器打印流程另存为 PDF。
这是什么¶
dsh-markdown-export 是一个 DSH 客户端插件：仅在文档预览中、且当前打开的是 .md / .markdown 时出现导出入口。Host 端 index.js 为空实现，逻辑全部在浏览器侧的 client.js 完成。源码与说明见 GitHub 仓库，社区目录页为 SkillHub 条目。许可证为 MIT（package.json 中包版本为 1.2.2）。
核心功能¶
下面介绍 README 中已写明、且与实现描述一致的能力。
导出 HTML¶
选择 HTML document 后，会下载一个与源文件同名的 .html。样式内联，本地图片在限制内嵌入为 data URI（最多 16 张、合计不超过 10 MiB），文件可离线打开、便于转发。远程 http(s) 图片仍保留为链接，打开 HTML 时需要网络。
导出 PDF¶
选择 PDF document 后，插件把同一份渲染结果放进隐藏的 iframe，调用 print() 打开系统打印对话框；在对话框里选择 PDF 打印机或「另存为 PDF」。分页与打印样式由专用 print stylesheet 处理（例如代码块、表格、图片尽量 break-inside: avoid）。PDF 不是直接下载文件，而是走浏览器打印管线。
与预览一致的数据与安全边界¶
导出通过 Harness 的 workspaceFiles Remote 读取 Host 上当前文件字节，与预览读的是同一路径。内置渲染器解析 Markdown，相对图片路径按文件所在目录解析。原始 HTML 在输出中被转义而非执行；javascript: / vbscript: 链接会被丢弃，便于分享导出物。
支持的 Markdown 语法¶
涵盖常见 GFM 用法：ATX / Setext 标题（含锚点 id）、强调与删除线、段落与换行、引用与列表（含任务列表）、围栏与缩进代码块、GFM 表格、链接与图片、脚注；YAML front matter 仅用于标题并从正文中剥离。围栏代码块的语言标签仅提供有限的高亮。详细表格见仓库 README。
界面语言¶
中英文文案随 DSH 应用 locale 切换（locale/en.json、locale/zh.json）。
安装与启用¶
官方说明是：在当前 Profile 里把插件目录作为 本地 bundle 安装，而不是通过 dsh plugin add github:… 一类未在文档中出现的命令。
- 打开 DeepSeek Harness Web UI。
- 使用插件管理器的
install_bundle动作，传入该插件目录的绝对路径。 - 变更立即生效；若页面已打开，刷新一次。
包声明了 dsh.bundle.patch（cordis.patch.yml 插入 markdown-export 行）和 dsh.client 所需注入包；无额外依赖与构建步骤。
典型用法¶
- 从工作区文件树打开一个
.md文件，使右侧出现文档预览。 - 在预览工具栏（刷新按钮旁）点击 Export。
- 选择格式：
- HTML document — 浏览器直接下载 HTML 文件。
- PDF document — 在打印对话框中选择 PDF 输出或「另存为 PDF」。
适用场景与注意¶
适合谁： 经常在 DSH 里写或审 Markdown 文档、需要把预览效果落成可分享 HTML 或 PDF 的开发者；希望导出内容与预览一致、且不想离开客户端换工具链的场景。
权限与安全： 插件随当前 DSH 客户端在浏览器中运行，读取的是你有权访问的工作区文件。安装前应自行查看 GitHub 源码 与 MIT 许可证，确认符合你的安全与合规要求。社区目录 SkillHub 是独立站点，与 DeepSeek / 幻方无官方从属关系，本文也不将其描述为官方应用商店。
已知限制（来自 README）：
- PDF 依赖系统打印对话框，无法像 HTML 一样一键直链下载。
- 超大文件受
workspaceFiles读取能力约束，导出的是完整文件读取结果，而非预览未加载的片段。 - 远程图片不会嵌入 HTML，离线打开时需能访问对应 URL。
结尾¶
dsh-markdown-export 把「预览即所见」延伸到导出：HTML 单文件可离线分享，PDF 走打印流程另存。若需要该能力，可在安装 bundle 后于任意 Markdown 预览工具栏使用 Export。
