Aspose.Words Markdown 文件处理器用于 .NET

NET 的 Aspose.Words 标记文件处理器 允许开发人员通过使用相同熟悉的对象模型编程创建、加载、编辑和保存 Markdown 文件.

安装和设置

  • 安装 NuGet 包 Aspose.Words.
  • 请求您的许可证 ( 计量许可 ).
  • 添加到 Aspose.Words 您的项目名称.
  • 对于框架目标和包装设置,请参见 安装指南 .

支持的平台:Windows、Linux、macOS、Mobile OS 与 .NET Framework、NET Core/5/6+ 或 Mono.IDEs: Visual Studio 2010–2022,Xamarin,MonoDevelop.

快速启动:创建一个 Markdown 文件 

var doc = new Document();
var builder = new DocumentBuilder(doc);

// Insert a horizontal rule (renders as '-----' in Markdown)
builder.InsertHorizontalRule();

doc.Save("Output.md");

特性和功能性

文档创作

  • 生成新 .md 动态文件.
  • 输入标题、段落、列表、表和代数据.
  • 设置文档级别属性,如标题、作者和标签.

文件加载

  • 现有负载 .md 来自磁盘、流或线条的文件.
  • 保存结构:标题、表、列表和内线格式.
  • 保持代码区块,代数据和参考风格链接.

DOM(文档对象模型)

  • 接入和操纵:

  • 段落 & Runs (bold, italic, strikethrough, inline 代码)

  • 头(H1 - H6)

  • 列表 (订购/未订单,切割)

  • 桌子、绳子和细胞

  • CodeBlock 和 InlineKode 节点

  • 链接和图像 (含字体、标题和URL)

文本和内线格式化

  • 通过运行属性应用 Markdown Syntax.
  • 勇敢的支持 (**), 意大利语 (*), 紧密 (~~), 和 Inline 代码 (```).
  • 以可靠的方式处理段落和列表的格式化.

首席和部分

  • 编程调整标题水平.
  • 重组 TOC 生成部分.
  • 分裂或合并基于标题的区块.

列表和Nested Lists

  • 命令 (1., 2.) 或 被指控 (-, *) 列表.
  • 将段落转化为列表项目.
  • 以动态的方式输入、删除或转换列表类型.

桌子

  • 创建和操纵GitHub的标记表.
  • 插入行/列,合并细胞,编辑内容.
  • 多线细胞支持保存格式化.

图片和链接

  • 添加或更新图像参考 (![alt](url "title")).
  • 添加链接 ([text](url "title")).
  • 支持 inline 和 reference-style 链接合成.

代码区块

  • 插入包含语言标签(‘csharp’)的密码区块).
  • 管理内线代码字符串与自动逃避.
  • 定制窗帘风格(背板或甲板).

金属与前方

  • 阅读/写 YAML 或 TOML 前提.
  • 保持静态位置发电机(Hugo、Jekyll等)的代数据.).

储蓄和出口

  • 保存回 .md 与选项:

  • 保留白空间和评论.

  • 正常化索引和线终点.

  • 用 callbacks 播放或更新代码.

先进的例子

编辑现有 Markdown 

var doc = new Document("Quotes.md");
var builder = new DocumentBuilder(doc);

builder.MoveToDocumentEnd();
builder.ParagraphFormat.ClearFormatting();
builder.Writeln("\n");

// Insert inline code with backticks
var inlineCodeStyle = doc.Styles.Add(StyleType.Character, "InlineCode.3");
builder.Font.Style = inlineCodeStyle;
builder.Writeln("Produced by Aspose.Words Markdown Processor.");

doc.Save("UpdatedQuotes.md");

插入代码区块 

var builder = new DocumentBuilder(new Document());
builder.Writeln("```csharp");
builder.Writeln("Console.WriteLine(\"Hello Markdown\");");
builder.Writeln("```");

最佳实践

  • 使用 DOM APIs 而不是 regex 进行转型.
  • 将元素集成到前面,以确保发电机兼容性.
  • 重新使用文档对象进行包装更新.
  • 连锁变更,以尽量减少记忆使用.
  • 在服务器环境中提前加热API,以减少第一次通话延迟.
  • 在 CI/CD 管道中跟踪许可使用.

常见用例

  • 自动化 ** README 世代**.
  • 创建 知识基础文章 动态.
  • 将结构化数据转换为 Markdown 文件.
  • 保持大文件设置编程.
  • 对静态位置发电机进行 Markdown 准备.

FAQ

**哪些 Markdown 功能支持?**标题、列表、表格、图像、链接、内线格式、代码区块和前面内容.

**我可以将 Markdown 转换为其他格式吗?**是的,加载 .md 并保存到DOCX,PDF,或HTML使用Aspose.Words.

**前面是保留的吗?**是的. YAML 和 TOML 前面内容的部分是阅读/写的.

**它是否支持参考风格链接?**是的,支持了内线和参考风格的链接.

**这是安全的吗?**是的,只要每个条纹使用自己的文档例子.

 中文