MarkdownRender 设计文档

Markdown 渲染组件:unified 管线(remark-parse + 条件 remark-gfm + remark-rehype + 透传 remark/rehype 插件)把 raw 编译成 hast,再由 Svelte 递归渲染成组件 / 原生标签。支持 components 覆盖元素与注册自定义标签对应的 Svelte 组件;默认剥离 raw HTML(对齐 Semi format=md,保留 HTML 需自传 rehype-raw 并自负 XSS);代码块默认交给 CodeHighlight(存在则用,否则降级纯 <pre><code>)。不支持 md 正文里任意 JSX 表达式求值(Semi format=mdx 深度能力,Svelte 无 JSX runtime)。

← API 文档

使用建议

Markdown 渲染组件:unified 管线(remark-parse + 条件 remark-gfm + remark-rehype + 透传 remark/rehype 插件)把 raw 编译成 hast,再由 Svelte 递归渲染成组件 / 原生标签。支持 components 覆盖元素与注册自定义标签对应的 Svelte 组件;默认剥离 raw HTML(对齐 Semi format=md,保留 HTML 需自传 rehype-raw 并自负 XSS);代码块默认交给 CodeHighlight(存在则用,否则降级纯 <pre><code>)。不支持 md 正文里任意 JSX 表达式求值(Semi format=mdx 深度能力,Svelte 无 JSX runtime)。

Accessibility

  • 渲染语义化 HTML(标题 / 列表 / 表格 / 链接等)保留原生可访问性;外链自动补 rel=noopener noreferrer + target=_blank;默认剥离 raw HTML 规避注入;图片 alt 由 Markdown 源码 `![alt](url)` 提供。

设计变量

该组件暂无专属设计变量。