dsh-tool-markdown 使用指南

DSH 工具插件，提供 HTML↔Markdown 互转、GFM 表格规范化与目录生成；零依赖手写解析器，纯函数安全转换。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

— 源: plugin_wiki.wiki_content

dsh plugin --profile web add github:omdsh-dev/dsh-toolkit#path:packages/dsh-tool-markdown

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

这个工具能自动抽取网页正文吗？

不能。本插件只做 HTML↔Markdown 的字面映射，不带 Readability 之类的正文选择算法——网页的导航/页头/页脚会原样透传。

输入超大会被截断吗？

不会。超过 maxBytes 会直接报错而不是悄悄截断：默认上限 256KB，硬顶 1MB。

md2html 输出可以直接渲染到网页上吗？

可以。文本一律 HTML 转义，输出标签严格限定在白名单内（p/h1-h6/ul/ol/li/blockquote/pre/code/a/img/strong/em/br/hr/table 等），javascript:/data: 链接自动降级为纯文本。

HTML 实体字符会处理正确吗？

命名实体和数字实体都会解码；未知实体按字面保留，不做二次解码（例如 &lt; 解码后是 <，不会变成 <）。

工具参数会被记录到哪里？

工具参数会写进会话日志（和模型调用记录在一起），所以不要把含密钥或会话 cookie 的 HTML 当作入参传入。

这个插件和 dsh-tool-csv 怎么选？

csv 工具处理结构化表格（CSV 解析/查询/统计）；markdown 工具处理文档与网页（HTML/Markdown 互转、HTML 表格转 GFM 表格、目录生成）。两者互补。

不安装到 web profile 而装到 headless 可以吗？

可以，但 web 与 headless 是两个独立的 profile，不会互相覆盖。dsh run 默认使用 headless profile。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则