CodeWF.Markdown

Avalonia Markdown 渲染控件

基于 Avalonia 的 Markdown 渲染控件：代码高亮、数学公式、图片预览、增量渲染，17 套排版主题；Lite 版轻量无重依赖；一行代码导出 PNG/PDF/Word 与社交平台富 HTML。

net8.0net10.0net11.0 MarkdownAvalonia渲染控件开源免费

> dotnet add package CodeWF.Markdown

GitHub ↗

GitHub Star ★ 58

NuGet 下载 1.2w+

子包数量 4

为什么选它

Features

🖼️

完整渲染

代码高亮、SVG/GIF 预览、数学公式、增量渲染，Full 版全覆盖。

🎨

17 套排版主题

微信、极客黑等多套主题，成稿风格一键切换。

📤

一行导出

MarkdownDocumentExporter 导出 PNG / PDF / Word。

📋

社交剪贴板

TrySetMarkdownHtmlAsync 直接产出公众号/知乎可用富 HTML。

🪶

Lite 版本

去除重依赖的轻量 Viewer，嵌入更干净。

🌐

图片来源齐全

data:/本地/file:///HTTP 图片加载，32MiB 上限保护。

Markdown

Markdown.Themes

Markdown.Lite

Markdown.Lite.Themes

> dotnet add package CodeWF.Markdown

核心包按需引入；目标框架 net8.0 / net10.0 / net11.0。全部包在 nuget.org 与 GitHub 同步发布。

一行代码导出多种格式

csharp

MarkdownDocumentExporter.ExportMarkdown(
    markdown,
    ExportKind.Pdf,
    "Simple",
    "article.pdf");

MarkdownDocumentExporter.ExportFile(
    @"C:\docs\article.md",
    ExportKind.Word,
    MarkdownTypographyThemes.Simple,
    "article.docx");

包列表

Packages

按需安装，版本与核心包保持同步发布

包名	说明
CodeWF.Markdown	核心包
CodeWF.Markdown.Themes	集成 / 扩展包
CodeWF.Markdown.Lite	集成 / 扩展包
CodeWF.Markdown.Lite.Themes	集成 / 扩展包

文档

Documentation 全部文档 →

1 Markdown.com.cn 简介

建议使用 Chrome 浏览器，体验最佳效果。

阅读 → 02 排版主题与资源 Key

这份文件用于确认排版主题切换方式是否正确。MarkdownThemes 可以统一设置默认排版主题与尺寸，MarkdownViewer 也可以单独设置 TypographyTheme 和 TypographySize，适合同一个项目里多处预览区使用不同阅读密度。主题包统一使用固定资源 Key，例如 B

阅读 → 03 代码与表格

这份文件用于检查代码块高亮、复制按钮、长代码行、表格对齐和复杂单元格内容。代码块语言标签应显示在左上方，复制按钮应显示在右上方。

阅读 → 04 列表、引用与 HTML fallback

这份文件用于检查列表嵌套、任务列表、引用块内的复杂内容，以及 HTML 内容的 fallback 渲染。当前控件不执行 HTML，只把 HTML 文本安全显示出来。

阅读 →