基于 Avalonia 12 的 Markdown 渲染控件、排版主题和可运行示例。该仓库从 CodeWF.AvaloniaControls 拆分而来，只保留 Markdown 相关代码与文档。
更新日志：UpdateLog.md
| 名称 | NuGet | 下载量 |
|---|---|---|
| CodeWF.Markdown |  |  |
| CodeWF.Markdown.Themes |  |  |
- 当前版本：
12.1.1.3，版本号统一维护在根目录Directory.Build.props的<Version>节点。 - NuGet 包项目统一支持
net8.0;net10.0；Demo、App、测试与内部应用项目统一使用net11.0/net11.0-windows。 - 根目录
logo.svg、logo.png、logo.ico是唯一图标源，子工程只通过 MSBuildLink引用，不维护图标副本。 - 运行时帮助、Markdown 示例、内置备忘录、设计说明等业务文档按功能保留；仓库级入口文档使用根目录
README.md和UpdateLog.md。
CodeWF.Markdown：完整 MarkdownViewer，支持常见 Markdown 元素、代码高亮、图片预览、SVG/图片、数学渲染扩展、多语言资源和增量渲染。CodeWF.Markdown.Themes：CodeWF.Markdown的默认控件模板和多套排版主题。
CodeWF.Markdown 也提供可复用的 Markdown 图片工具，方便宿主应用把 Markdown 导出为可离线分发的文件。MarkdownImageSourceLoader 支持加载 data:image、本地路径、file:// 和 HTTP(S) 图片，相对路径会按当前 Markdown 文档路径解析，并尝试 URL 解码后的文件名。MarkdownImageRasterizer 可把已加载的 SVG、GIF 首帧和其他位图格式转换为静态 PNG 字节，PDF、PNG、Word 或其他导出链路可以直接嵌入图片，不必重复实现预览控件里的图片加载逻辑。
MarkdownDocumentExporter 为宿主应用提供一行调用的 PNG/PDF/Word 导出能力：
MarkdownDocumentExporter.ExportMarkdown(markdown,ExportKind.Pdf,"Simple","article.pdf");MarkdownDocumentExporter.ExportFile(@"C:\docs\article.md",ExportKind.Word,MarkdownTypographyThemes.Simple,"article.docx");vardocument=newMarkdownExportDocument(markdown,filePath,fileName);MarkdownDocumentExporter.Export(document,ExportKind.Png,"article.png");内置 PNG/PDF/Word 导出器会复用公共图片加载与栅格化能力。Word 输出会把图片写入 word/media；PDF 输出会写入可选择文本，包含用于复制粘贴的 Unicode 文本映射，并把 Markdown 图片作为 PDF 图片内容嵌入，不再把整页压平成单张位图。
MarkdownHtmlClipboard 和 MarkdownHtmlClipboardExtensions 为宿主应用提供可复用的富 HTML 剪贴板载荷，适合把 Markdown 渲染后的 HTML 复制到微信公众号、知乎、稀土掘金等网页编辑器。它会同时写入 text/plain、text/html、macOS public.html 和 Windows HTML Format；Windows 载荷使用带正确片段偏移的 UTF-8 CF_HTML 字节，避免 Chromium 系编辑器把带样式 HTML 当作普通文本显示。
Avalonia 剪贴板扩展的简单调用只需要当前 Markdown、排版主题和目标平台：
awaitclipboard.TrySetMarkdownHtmlAsync(markdown,MarkdownTypographyThemes.Simple,"wechat",MarkdownTypographySizes.Small);awaitclipboard.SetMarkdownHtmlAsync(markdown,MarkdownExportStyle.Resolve("Simple","Small"),CopyKind.Zhihu);内置目标包括 CopyKind.Wechat、CopyKind.Zhihu 和 CopyKind.Juejin；字符串目标名由 MarkdownSocialCopyProfiles 解析，方便宿主应用直接复用菜单命令参数。基于 Markdown 字符串复制时，相对图片按当前工作目录解析；基于 Markdown 文件生成内容时，相对图片可按文件路径解析。后续新增发布平台时，应用可传入自定义 MarkdownSocialCopyProfile，继续复用同一套 CF_HTML 剪贴板写入能力。
粘贴方向可使用 MarkdownHtmlClipboard.Html2Markdown(htmlContent)，把从网页复制到剪贴板的 HTML 转为 Markdown，覆盖标题、段落、链接、图片、列表、引用、代码块和表格等常见结构。转换器内置在 CodeWF.Markdown 中，不额外引入第三方包。
varmarkdown=MarkdownHtmlClipboard.Html2Markdown(htmlContent);Install-Package CodeWF.Markdown
Install-Package CodeWF.Markdown.Themes在 App.axaml 引入主题包：
<Applicationxmlns="https://github.com/avaloniaui"xmlns:markdown="https://codewf.com">
<Application.Styles>
<FluentTheme />
<markdown:MarkdownThemes />
</Application.Styles>
</Application>可以在 MarkdownThemes 上设置全局默认，也可以在 MarkdownViewer 上设置单个 Viewer 覆盖。TypographyTheme 和 TypographySize 可不填，默认是 Basic 和 Normal。
<UserControlxmlns="https://github.com/avaloniaui"xmlns:md="https://codewf.com">
<ScrollViewerHorizontalScrollBarVisibility="Disabled"VerticalScrollBarVisibility="Auto">
<md:MarkdownViewerMarkdown="{Binding Markdown}"TypographyTheme="Simple"TypographySize="Small" />
</ScrollViewer>
</UserControl>示例工程包含实时编辑、样例文档加载、排版主题切换和增量渲染压力测试。
内置主题名继续使用 MarkdownTypographyThemes.Simple 这样的字符串常量，而不是改成 enum，是为了让宿主应用可以注册自己的主题 Key。自定义主题复用内置主题同一套资源 Key：
MarkdownTypographyThemeRegistry.Register("MyCompanyBlue",()=>newResourceDictionary{[MarkdownStyleKeys.TextBrushResource]=newSolidColorBrush(Color.Parse("#1F2937")),[MarkdownStyleKeys.MutedTextBrushResource]=newSolidColorBrush(Color.Parse("#64748B")),[MarkdownStyleKeys.AccentBrushResource]=newSolidColorBrush(Color.Parse("#0E88EB")),[MarkdownStyleKeys.BorderBrushResource]=newSolidColorBrush(Color.Parse("#BFDBFE")),[MarkdownStyleKeys.ParagraphFontSizeResource]=16d,[MarkdownStyleKeys.ParagraphLineHeightResource]=28d,[MarkdownStyleKeys.Heading1FontSizeResource]=32d,[MarkdownStyleKeys.CodeBlockFontSizeResource]=13d});MarkdownThemes.OverrideTypographyResources(Application.Current!,"MyCompanyBlue",MarkdownTypographySizes.Normal);varexportStyle=MarkdownThemes.CreateExportStyle("MyCompanyBlue");MarkdownDocumentExporter.ExportMarkdown(markdown,ExportKind.Pdf,exportStyle,"article.pdf");最简单的导出和自媒体复制 API 会通过 MarkdownExportStyle.Resolve 解析内置主题名和排版尺寸。如果应用需要完全接管导出外观，也可以直接构造并传入 MarkdownExportStyle。如果应用已有自己的 XAML 资源字典，可以注册 () => new MyCompanyMarkdownResources()，并在需要共享自定义资源时通过 MarkdownThemes.CreateExportStyle(...) 生成导出样式，让预览、PNG/PDF/Word 导出和自媒体复制 HTML 都从同一套排版资源解析样式。
src/CodeWF.Markdown：完整 MarkdownViewer 类库src/CodeWF.Markdown.Themes：完整版本控件模板和排版主题src/CodeWF.Markdown.Sample：完整版本示例工程tests/CodeWF.Markdown.Tests：渲染和差异服务测试CodeWF.Markdown.slnx：Markdown 类库、示例和测试的解决方案视图
dotnet restore CodeWF.Markdown.slnx
dotnet build CodeWF.Markdown.slnx --no-restore打包 NuGet：
.\pack.bat发布示例工程到 win-x64 和 linux-x64：
.\publish_Markdown.batMIT，详见 LICENSE。
检查时间：2026-05-23。检查范围包括 NuGet 元数据、恢复后的 project.assets.json、NuGet.org 信息以及上游源码/许可证链接。优先接受 MIT / Apache-2.0 / BSD。
本次整改：
- 将
Semi.Avalonia.AvaloniaEdit替换为开源Avalonia.AvaloniaEdit。 - 示例工程移除
AvaloniaEditSemiTheme，编辑器渲染改为使用开源 AvaloniaEdit 控件和本仓库自己的 Markdown 主题。
传递依赖检查结论：Avalonia、AnimatedImage、SkiaSharp、Svg.Skia、CSharpMath、TextMateSharp 等链路均有公开源码，许可证为 MIT 或 BSD-style。有效项目文件中不再包含 Semi.Avalonia.AvaloniaEdit。
XML 文件统一使用两个空格缩进。Directory.Packages.props 统一承载 NuGet 中央包管理开关和包版本变量，包括 AvaloniaVersion 等共享版本属性；Directory.Build.props 仅保留项目构建、编译选项和 NuGet 元数据。仓库如引用 VC-LTL、YY-Thunks，这两个兼容旧版操作系统的特殊包必须使用最新预览版。