如何在 C# 中创建 Markdown 列表
Aspose.HTML for .NET
库是一个独立的解决方案,允许您在不使用其他软件的情况下解析和操作 Markdown 文件。您可以从头开始创建 Markdown 文档,从本地文件打开并通过插入新元素、删除或编辑现有节点的内容来进行操作。 Markdown 支持有序(编号)和无序(项目符号)列表。在本文中,您将了解如何使用 C# 库在 Markdown 中添加列表。
使用
Aspose.Html.Toolkit.Markdown.Syntax
和
Aspose.Html.Toolkit.Markdown.Parser
命名空间以提供基于 GitHub Flavored Markdown (GFM) 规范的完整 Markdown 解析和 MD 语法树管理.
在 C# 中创建 Markdown 有序列表
使用 C# 库,您可以以编程方式编辑 MD 文件 – 更改文档结构和内容。让我们看看从头开始创建一个新的 Markdown 文档并向其中添加 Markdown 有序列表。
用于创建 Markdown 有序列表的 C# 代码
// Create the MarkdownSyntaxTree
var md = new MarkdownSyntaxTree(new Configuration());
// Create a Markdown syntax factory
var mdf = md.SyntaxFactory;
// Create a new empty odered list node
var orderedList = mdf.OrderedList();
// Create and add to the odered list a li1 item with the marker “1”
var li1 = mdf.OrderedListItem(1);
orderedList.AppendChild(li1);
// Create a paragraph with text content and add it to the li1 item
var paragraph = mdf.Paragraph();
var heading = mdf.AtxHeading("The first element in the Markdown ordered list is the level 3 heading.", 3);
paragraph.AppendChild(heading);
li1.AppendChild(paragraph);
//Create and add to the odered list a li2 item with the marker “2”
var li2 = mdf.OrderedListItem(2);
orderedList.AppendChild(li2);
// Create a strong emphasis with text content and add it to the li2 item
var bold = mdf.Emphasis(Emphasis.Strong);
bold.AppendChild(mdf.Text("The second item in the Markdown ordered list is in bold."));
li2.AppendChild(bold);
// Add orderedList to MD syntax tree
md.AppendChild(orderedList);
// Prepare a path for MD file saving
string savePath = Path.Combine(OutputDir, "output-odered-list.md");
// Save MD file
md.Save(savePath);
在 C# 中创建 Markdown 有序列表的步骤
以下是创建 Markdown 有序列表的几个简单步骤:
- 使用 MarkdownSyntaxTree() 构造函数创建 MarkdownSyntaxTree。
- 使用 SyntaxFactory 属性获取用于创建 Markdown 语法树的工厂。
- 使用 SyntaxFactory 中的 OderedList() 构造函数创建一个新的 orderedList 节点。
- 使用 OrderedListItem() 构造函数创建 ListItemSyntaxNode 类的新实例有序列表项标记。
- 调用MarkdownSyntaxNode类的 AppendChild() 方法将排序列表项添加到无序列表节点。
- 将所有项目及其内容收集到单个 orderedList 元素后,将其添加到文档语法树中。
在 C# 中创建无序列表
以下 C# 代码示例显示了如何将无序列表添加到 MD 文件:
C#代码将无序列表添加到MD文件
// Create the MarkdownSyntaxTree
var md = new MarkdownSyntaxTree(new Configuration());
// Create a Markdown syntax factoty
var mdf = md.SyntaxFactory;
// Create a new empty unodered list node
var unorderedList = mdf.UnorderedList();
// Create and add to the unodered list a li1 element with the marker “-”
var li1 = mdf.UnorderedListItem("-");
unorderedList.AppendChild(li1);
// Create a paragraph with text content and add it to the li1 item:
var paragraph = mdf.Paragraph();
paragraph.AppendChild(mdf.Text("The first item of the unordered Markdown list."));
li1.AppendChild(paragraph);
// Create and add to the unodered list a li2 element with the marker “-”
var li2 = mdf.UnorderedListItem("-");
unorderedList.AppendChild(li2);
// Create a paragraph with text content and add it to the li2 item:
var paragraph2 = mdf.Paragraph();
paragraph2.AppendChild(mdf.Text("The second item of the unordered Markdown list."));
li2.AppendChild(paragraph2);
// Add unorderedList to MD syntax tree
md.AppendChild(unorderedList);
// Prepare a path for MD file saving
string savePath = Path.Combine(OutputDir, "markdown-unodered-list.md");
// Save MD file
md.Save(savePath);
文档
要了解有关 Aspose.HTML API 的更多信息,请访问我们的
文档
指南。 Markdown 是一种简单的标记语言,可让您格式化纯文本。
Markdown 语法
文档文章提供了有关 Markdown 主要元素的信息、Markdown 语法的详细信息和示例。
FAQ
用于 Aspose.HTML for .NET 库是一个独立的解决方案,用于处理不依赖于其他软件的 Markdown 文档。安装我们的 C# 库,将库引用添加到您的 C# 项目,并以编程方式处理 Markdown 文档
由于其多功能性,Markdown 在作家、开发人员和内容创作者中非常受欢迎。 其优点包括易于学习和使用的语法、可移植性、灵活性、可读性和可用性。 Markdown 简单直观,可以转换为 HTML、PDF 或其他格式。
您可以在任何操作系统上使用 Markdown 文档,无论您使用的是 Windows、Mac OS、Linux、Android 还是 iOS。
我们支持多种文件格式,您可以在 C# 中创建、打开、解析、编辑、保存或转换它们。这些是 HTML、XHTML、MHTML 和 Markdown 格式。
Aspose.HTML for .NET API 入门
您可以通过多种方式在系统上安装 Aspose.HTML for .NET 库:
- 使用 NuGet 包管理器 GUI 安装 NuGet 包。
- 使用包管理器控制台安装 NuGet 包。
- 通过 MSI 安装 Aspose.HTML for .NET。
该库支持解析 HTML5、CSS3、SVG 和 HTML Canvas,以构建基于 WHATWG DOM 标准的文档对象模型 (DOM)。 Aspose.HTML for .NET 完全用 C# 编写,可用于构建任何类型的 32 位或 64 位 .NET 应用程序,包括 ASP.NET、WCF、WinForms 和 .NET Core。在运行 .NET 转换示例代码之前,请确保您拥有 Microsoft Windows 等操作系统或与 .NET Framework 或 .NET Standard 兼容的操作系统,以及 Microsoft Visual Studio 等开发环境。有关 C# 库安装和系统要求的更多详细信息,请参阅
Aspose.HTML 文档
。
系统要求
所有主要平台和操作系统都支持我们的 API。在执行代码之前,请确保您的系统具备以下先决条件。
- Microsoft Windows 或具有 .NET Framework、.NET Core、Windows Azure、Mono 或 Xamarin 平台的兼容操作系统。
- Microsoft Visual Studio 等开发环境。
- Aspose.Html for .NET DLL 在您的项目中引用 – 使用上面的下载按钮从 NuGet 安装。