MarkdownView Markdown 渲染

用法

基础

content 是唯一输入，按 GFM 解析。

丰富 Markdown

主题

theme 固定亮色或暗色；auto 跟随文档主题。

最佳实践

• 用户生成、远程加载或插件提供的内容保持 sanitize 开启。
• 传入已标准化的 Markdown；除非明确依赖 Markdown HTML，不要混入半转义的 HTML。
• 预览、卡片等不跟随文档主题的表面显式设置 theme。
• 只用于展示；需要编辑时在外部组合编辑器或 textarea。

API 参考

属性

概述

• 用 marked 解析，开启 gfm 与 breaks（单个换行即换行）。
• sanitize=true 时 DOMPurify 就绪前不渲染；其动态导入失败则渲染空内容。
• sanitize=false 时输出直接经 v-html 写入，只用于可信内容。
• theme="auto" 读取并监听 html 与 body 的 data-theme 及 light / dark class。
• 外层容器带解析后的 light / dark class 与同值的 data-theme。

技术实现

• 内置的 github-markdown.css 全局引入并与 TxStreamMarkdown 共用，每条规则限定在 :where(.tx-markdown-view, .tx-stream-md) 下，不影响宿主自己的 .markdown-body；重新引入上游版本时保留该限定。
• 源码：packages/tuffex/packages/components/src/markdown-view/。