C# 中的 Markdown 图片

通过 C# 在 Markdown 中的图像

可以使用 Markdown 语法将图像添加到任何 Markdown 文件。在本文中，您将了解如何使用 C# 在 Markdown 中添加图像、将图像显示为链接以及将 altText 添加到 Markdown 图像。 Aspose.HTML for .NET 库是一个独立的解决方案，允许您在不使用其他软件的情况下解析和操作 Markdown 文件。您可以从头开始创建 Markdown 文档，从本地文件打开并通过插入新元素、删除或编辑现有节点的内容来进行操作。
使用 Aspose.Html.Toolkit.Markdown.Syntax 和 Aspose.Html.Toolkit.Markdown.Parser 命名空间以提供基于 GitHub Flavored Markdown (GFM) 规范的完整 Markdown 解析和 MD 语法树管理.

如何使用 C# 在 Markdown 中添加图像

使用 C# 库，您可以以编程方式编辑 MD 文件 – 更改文档结构和内容。让我们看看从头开始创建一个新的 Markdown 文档并向其中添加图像。

    // Create the MarkdownSyntaxTree
    var md = new MarkdownSyntaxTree(new Configuration());

    // Create a Markdown syntax factory
    var mdf = md.SyntaxFactory;

    // Specify an image altText
    var altText = "The San Juan Mountains are beautiful";

    // Specify an image label
    var label = "San Juan Mountains";

    // Specify the path to an image
    var href = "C:/temp/image.png";

    // Create an Image element:
    var image = mdf.InlineImage(altText, href, label);

    // Add the image into MD document
    md.AppendChild(image);

    // Prepare a path for MD file saving 
    string savePath = Path.Combine(OutputDir, "markdown-image.md");

    // Save MD file
    md.Save(savePath);

在 C# 中将图像添加到 MD 文件的步骤

创建 Markdown 图片的几个简单步骤：

1. 使用 MarkdownSyntaxTree() 构造函数创建 MarkdownSyntaxTree。
2. 使用 SyntaxFactory 属性获取用于创建 Markdown 语法树的工厂。
3. 指定图像 altText、标签和图像路径，并将它们传递给 InlineImage()。
4. 使用 SyntaxFactory 中的 InlineImage() 构造函数创建图像元素。
5. 调用MarkdownSyntaxNode类的 AppendChild() 方法将图片添加到MD中语法树。

在 C# 中添加 Markdown 图像作为链接

以下 C# 代码示例显示了如何将图像作为链接添加到 MD 文档中：

    // Create the MarkdownSyntaxTree
    var markdown = new MarkdownSyntaxTree(new Configuration());

    // Create a link node and add it to Markdown syntax tree
    var link = markdown.SyntaxFactory.InlineLink("", "https://docs.aspose.com/html/", "");
    markdown.AppendChild(link);

    // Markdown Image Link – create an image node and add it as a link
    var image = markdown.SyntaxFactory.InlineImage("Aspose.HTML for .NET", "https://products.aspose.com/html/images/headers/aspose_html-for-net.svg", "C# HTML Parser – Documentation");
    link.AppendChild(image);
            
    // Prepare a path for MD file saving 
    string savePath = Path.Combine(OutputDir, "markdown-image-link.md");

    // Save MD file
    markdown.Save(savePath);

文档

要了解有关 Aspose.HTML API 的更多信息，请访问我们的 文档 指南。 Markdown 是一种简单的标记语言，可让您格式化纯文本。 Markdown 语法 文档文章提供了有关 Markdown 主要元素的信息、Markdown 语法的详细信息和示例。

FAQ

Aspose.HTML for .NET API 入门

您可以通过多种方式在系统上安装 Aspose.HTML for .NET 库：

1. 使用 NuGet 包管理器 GUI 安装 NuGet 包。
2. 使用包管理器控制台安装 NuGet 包。
3. 通过 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 安装。