Convertir HTML Markdown C#

Markdown es un lenguaje de marcado con símbolos simples que denotan encabezado, negrita, cursiva, subrayado y mucho más. Es fácil de aprender y escribir, por lo que la mayor parte de la documentación en línea y los archivos Léame se escriben con Markdown. Puede convertir Markdown a una página web HTML fácilmente con unos pocos pasos rápidos. Del mismo modo, la conversión de HTML a Markdown también es una característica útil que exploraremos aquí usando el lenguaje C#.

Convertidor de HTML y Markdown: instalación de la API

Puede interconvertir la página web HTML y los archivos de formato Markdown utilizando el lenguaje de programación C#. Debe instalar Aspose.HTML for .NET API para manipular y convertir estos formatos de archivo. Puede instalar la API desde la galería NuGet con el siguiente comando de instalación, o puede descargar el archivo DLL desde la sección Descargas, para agregarlo como referencia en su proyecto.

PM> Install-Package Aspose.Html

Hasta ahora, podrá configurar la API en un par de minutos. Procedamos a recorrer diferentes escenarios posibles:

Convierta una página web HTML en Markdown (.md) mediante programación en C#

Puede convertir una página web HTML a Markdown en sus aplicaciones basadas en .NET. Esta característica de conversión popular es compatible de manera que solo necesita llamar a la API sin entrar en los detalles de los formatos de archivo subyacentes. Por lo tanto, debe seguir los pasos a continuación para la conversión de páginas web HTML:

  1. Cree un archivo HTML o cargue el archivo de entrada existente
  2. Llame al método ConvertHTML con el objeto MarkdownSaveOptions
  3. Guardar archivo Markdown (.md) de salida

El siguiente código muestra cómo convertir una página web HTML a Markdown usando C#:

// Prepare un código HTML y guárdelo en el archivo.
var code = "<h1>Header 1</h1>" +
            "<h2>Header 2</h2>" +
            "<p>Hello World!!</p>";
System.IO.File.WriteAllText(dataDir + "document.html", code);

// Llame al método ConvertHTML para convertir HTML a Markdown.
Aspose.Html.Converters.Converter.ConvertHTML(dataDir + "document.html", new Aspose.Html.Saving.MarkdownSaveOptions(), dataDir + "output.md");

Convierta una página web HTML en Markdown MD (.md) con opciones adicionales en C#

Ya hemos aprendido el caso de uso simple y básico de convertir HTML a notación Markdown. Avancemos un paso más allá donde estaremos controlando el proceso de conversión. Considere un escenario en el que hay una gran cantidad de datos irrelevantes en un archivo HTML, pero solo necesitamos convertir el contenido en etiquetas de párrafo o hipervínculo. Seguiremos los pasos a continuación para comprender y probar esta función:

  1. Cargar un archivo HTML de entrada
  2. Inicializar el objeto MarkdownSaveOptions
  3. Establezca las variables de bandera en la propiedad Características
  4. Guardar archivo Markdown de salida

El siguiente código se basa en estos pasos que muestran cómo convertir una página web HTML a Markdown con opciones adicionales usando C#:

// Prepare un código HTML y guárdelo en el archivo.
var code = "<h1>Header 1</h1>" +
            "<h2>Header 2</h2>" +
            "<p>Hello World!!</p>" +
            "<a href='aspose.com'>aspose</a>";
System.IO.File.WriteAllText(dataDir + "document.html", code);

// Cree una instancia de SaveOptions y configure la regla: 
// - solo <a>y</a><p> <a>los elementos se convertirán en rebajas.</a>
var options = new Aspose.Html.Saving.MarkdownSaveOptions();
options.Features = Aspose.Html.Saving.MarkdownFeatures.Link | Aspose.Html.Saving.MarkdownFeatures.AutomaticParagraph;

// Llame al método ConvertHTML para convertir el HTML a Markdown.
Aspose.Html.Converters.Converter.ConvertHTML(dataDir + "document.html", options, dataDir + "output_options.md");

Convierta Markdown (.md) en una página web HTML mediante programación usando C#

Es posible que deba convertir HTML a notación Markdown en algunos escenarios. Por ejemplo, algunas secciones de documentación se utilizan en aplicaciones web y muchos otros casos de uso. Puede convertir fácilmente el archivo Markdown a HTML con los siguientes pasos:

  1. Cree un archivo Markdown (.md) o cargue el archivo de entrada
  2. Guarde el archivo HTML de salida con el método ConvertMarkdown

El siguiente código muestra cómo convertir un archivo Markdown (.md) a una página web HTML utilizando el lenguaje de programación C#:

// Prepare un ejemplo de Markdown simple
var code = "### Hello World" +
            "\r\n" +
            "[visit applications](https://products.aspose.app/html/family)";
// Crear un archivo Markdown
System.IO.File.WriteAllText(dataDir + "input_document.md", code);

// Convertir Markdown a documento HTML
Aspose.Html.Converters.Converter.ConvertMarkdown(dataDir + "input_document.md", dataDir + "MarkdownToHTMLoutput.html");

Descargar proyecto de ejemplo y archivos de muestra

Hemos compilado un proyecto de muestra como demostración de las características antes mencionadas donde también puede descargar los archivos de muestra. Es una aplicación de consola que puede probar para explorar y comprender las funciones de reducción de precio y de conversión HTML. Por lo tanto, puede descargar el ZIP o clonar el Repositorio de GitHub para probar las funciones.

Conclusión

En pocas palabras, hemos explorado en detalle la conversión de páginas web HTML y archivos Markdown. La API puede convertir estos archivos de forma rápida y eficiente con simples llamadas a la API. Además, puede conocer otras funciones visitando Documentación del producto y Referencias de la API. Sin embargo, si tiene alguna inquietud, no dude en ponerse en contacto con nosotros a través del Foro de soporte gratuito.

Ver también