Imagen en Markdown a través de C#
Las imágenes se pueden agregar a cualquier archivo de Markdown utilizando la sintaxis de Markdown. En este artículo, aprenderá a agregar imágenes en Markdown, mostrar imágenes como enlaces y agregar texto alternativo a las imágenes de Markdown usando C#. La biblioteca
Aspose.HTML for .NET
es una solución independiente que le permite analizar y manipular archivos Markdown sin usar otro software. Puede crear un documento Markdown desde cero, abrirlo desde un archivo local y manipularlo insertando nuevos elementos, eliminando o editando el contenido de los nodos existentes.
Utilice
Aspose.Html.Toolkit.Markdown.Syntax
y
Aspose.Html.Toolkit.Markdown.Parser
espacios de nombres para proporcionar un análisis completo de Markdown y administración de árbol de sintaxis MD basada en la especificación GitHub Flavored Markdown (GFM).
Cómo agregar una imagen en Markdown usando C#
Con la biblioteca de C#, puede editar archivos MD mediante programación: cambiar la estructura y el contenido del documento. Veamos cómo crear un nuevo documento Markdown desde cero y agregarle una imagen.
Código C# para agregar una imagen a un archivo MD
// 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);
Pasos para agregar una imagen a un archivo MD en C#
Unos simples pasos para crear Markdown Image:
- Cree MarkdownSyntaxTree usando el constructor MarkdownSyntaxTree().
- Use la propiedad SyntaxFactory para obtener la fábrica para crear el árbol de sintaxis Markdown.
- Especifique un altText de imagen, una etiqueta y una ruta a la imagen y páselos a InlineImage().
- Cree un elemento de imagen usando el constructor InlineImage() en SyntaxFactory.
- Llame al método AppendChild() de la clase MarkdownSyntaxNode para agregar la imagen a MD árbol de sintaxis.
Agregue una imagen Markdown como un enlace en C#
El siguiente ejemplo de código C# muestra cómo agregar una imagen como vínculo en un documento MD:
Código C# para crear una imagen Markdown como enlace
// 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);
Documentación
Para obtener más información sobre la API de Aspose.HTML, visite nuestra guía
documentación.
Markdown es un lenguaje de marcado simple que le permite formatear texto sin formato. El artículo de documentación
Sintaxis de Markdown
proporciona información sobre los elementos principales de Markdown, detalles y ejemplos de la sintaxis de Markdown.
Introducción a la API Aspose.HTML for .NET
Puede usar varias formas de instalar la biblioteca Aspose.HTML for .NET en su sistema:
- Instale un Paquete NuGet mediante la GUI del Administrador de paquetes NuGet.
- Instale un paquete NuGet mediante la Consola del administrador de paquetes. Puede usar el siguiente comando
PM> Install-Package Aspose.Html
. - Instale Aspose.HTML for .NET a través de MSI.
Esta biblioteca admite el análisis de HTML5, CSS3, SVG y HTML Canvas para construir un modelo de objeto de documento (DOM) basado en el estándar WHATWG DOM. Aspose.HTML for .NET está escrito completamente en C# y se puede usar para crear cualquier tipo de aplicación .NET de 32 o 64 bits, incluidos ASP.NET, WCF, WinForms y .NET Core. Antes de ejecutar el código de ejemplo de conversión de .NET, asegúrese de tener un sistema operativo como Microsoft Windows o compatible con .NET Framework o .NET Standard, y el entorno de desarrollo como Microsoft Visual Studio. Para obtener más detalles sobre la instalación de la biblioteca de C# y los requisitos del sistema, consulte Documentación de Aspose.HTML.
Requisitos del sistema
Nuestras API son compatibles con todas las principales plataformas y sistemas operativos. Antes de ejecutar el código, asegúrese de tener los siguientes requisitos previos en su sistema.
- Microsoft Windows o un sistema operativo compatible con las plataformas .NET Framework, .NET Core, Windows Azure, Mono o Xamarin.
- Entorno de desarrollo como Microsoft Visual Studio.
- Aspose.HTML for .NET DLL a la que se hace referencia en su proyecto – Instale desde NuGet usando el botón Descargar de arriba.