Markdown 强大的 Markdown 渲染

s-markdown 用于安全渲染 CommonMark/GFM 或完整 HTML 片段，并扩展代码高亮、任务列表、脚注、数学公式、Mermaid、目录锚点、代码复制、图片预览和图片下载能力。

Hidden Title

基础用法：<s-markdown :source="source" />

属性事件插槽简介

基础用法（默认 `allowHtml=true`、`sanitize=true`、`linkify=true`、`highlight=true`、`mermaid=true`、`math=true`）

chenghua示例

完整语法

图片预览（默认 `imagePreview=true`）

点击 Markdown 图片后会打开全视口预览，支持放大、缩小、旋转、上一张、下一张、下载和关闭，也可以聚焦图片后按 Enter 或空格键打开。imagePreview 的可选值是 true 和 false，默认值是 true；设置为 false 可关闭点击预览。地址为空的图片不会生成破图元素，只显示图片的替代文字；加载失败或无法解码的图片会保留正文替代文字，但不会进入预览列表，上一张和下一张只会切换加载成功的图片。远程图片下载受浏览器同源策略限制，图片服务器未开放 CORS 时会回退为直接打开原图地址。

石景山项目部分代码示例

纯 HTML（默认 `contentType='markdown'`）

接口直接返回完整 HTML 片段时，使用 content-type="html" 跳过 Markdown 语法解析，避免 HTML 中的空行和缩进被识别为代码块。HTML 仍会经过默认开启的 DOMPurify 安全过滤。contentType 可选值为 markdown / html，默认值为 markdown。

API

属性名	说明	类型 / 可选值	默认值
`source`	Markdown 或 HTML 源文本	`string`	`''`
`contentType`	源文本解析模式，HTML 模式跳过 Markdown	`markdown / html`	`markdown`
`allowHtml`	是否解析源文本中的原始 HTML	`true / false`	`true`
`sanitize`	是否使用 DOMPurify 过滤输出	`true / false`	`true`
`breaks`	是否把普通换行转换为 `<br>`	`true / false`	`false`
`linkify`	是否自动识别 URL	`true / false`	`true`
`typographer`	是否启用排版替换	`true / false`	`true`
`highlight`	是否使用 Prism 高亮常用语言	`true / false`	`true`
`copyCode`	是否显示代码复制按钮	`true / false`	`true`
`mermaid`	是否渲染 `mermaid` 代码块	`true / false`	`true`
`math`	是否通过 KaTeX 渲染 $...$ 与 `$$...$$`	`true / false`	`true`
`headingAnchors`	是否为标题生成稳定 ID	`true / false`	`true`
`externalLinks`	是否让 HTTP(S) 链接在新窗口安全打开	`true / false`	`true`
`baseUrl`	相对链接和图片的解析基准地址	`string`	`''`
`imageLazy`	是否为图片启用懒加载和异步解码	`true / false`	`true`
`imagePreview`	是否允许点击图片打开全视口操作预览	`true / false`	`true`
`emptyText`	无内容时显示的文字	`string`	`''`

事件

事件名	说明	参数
`rendered`	Markdown 与异步增强完成后触发	`{ html, headings }`
`error`	解析、Mermaid 或复制失败时触发	`unknown`
`copy`	代码复制成功后触发	`code: string`
`link-click`	点击渲染结果中的链接时触发	`{ event, href }`

暴露方法与状态

名称	说明
`render()`	主动重新渲染当前内容
`renderedHtml`	当前生成并过滤后的 HTML
`headings`	标题目录数组，包含 `level`、`text`、`slug`
`state`	包含最终 `html` 和 `headings` 的只读状态

安全说明

默认 allowHtml=true，会解析 Markdown 中的原始 HTML。
完整 HTML 片段应设置 contentType='html'，跳过 Markdown 解析；sanitize 仍然生效。
如果内容来源不完全可信，建议继续保留默认的 sanitize=true。
服务端渲染且 sanitize=true 时，原始 HTML 会先按普通文字安全输出，自定义 HTML 属性暂不生效；客户端挂载后再通过 DOMPurify 过滤并渲染，避免未过滤内容进入服务端页面。
仅在内容完全可信且业务确实需要脚本级 HTML 能力时关闭 sanitize。
Mermaid 使用严格安全级别，外部链接自动增加 noopener noreferrer。

Markdown 强大的 Markdown 渲染 ​

Hidden Title ​

属性事件插槽简介 ​

基础用法（默认 allowHtml=true、sanitize=true、linkify=true、highlight=true、mermaid=true、math=true） ​

chenghua示例 ​

完整语法 ​

图片预览（默认 imagePreview=true） ​

石景山项目部分代码示例 ​

纯 HTML（默认 contentType='markdown'） ​

API ​

事件 ​

暴露方法与状态 ​

安全说明 ​