Convertir HTML Markdown C#

Markdown est un langage de balisage avec des symboles simples qui indiquent le titre, le gras, l’italique, le soulignement et bien plus encore. Il est simple à apprendre et à écrire, donc la plupart des documents en ligne et des fichiers Lisez-moi sont écrits à l’aide du démarquage. Vous pouvez facilement convertir le démarquage en page Web HTML en quelques étapes rapides. De même, la conversion HTML en démarque est également une fonctionnalité utile que nous allons explorer ici en utilisant le langage C#.

Convertisseur HTML et Markdown - Installation de l’API

Vous pouvez inter-convertir la page Web HTML et les fichiers au format Markdown à l’aide du langage de programmation C#. Vous devez installer l’API Aspose.HTML for .NET pour manipuler et convertir ces formats de fichiers. Vous pouvez soit installer l’API à partir de la galerie NuGet avec la commande d’installation suivante, soit télécharger le fichier DLL à partir de la section Téléchargements, pour l’ajouter comme référence dans votre projet.

PM> Install-Package Aspose.Html

Jusqu’à présent, vous pourrez configurer l’API en quelques minutes. Passons en revue différents scénarios possibles :

Convertir une page Web HTML en Markdown (.md) par programmation en C#

Vous pouvez convertir une page Web HTML en Markdown dans vos applications basées sur .NET. Cette fonctionnalité de conversion populaire est prise en charge de manière à ce que vous n’ayez qu’à appeler l’API sans entrer dans les détails des formats de fichiers sous-jacents. Par conséquent, vous devez suivre les étapes ci-dessous pour la conversion de pages Web HTML :

  1. Créez un fichier HTML ou chargez le fichier d’entrée existant
  2. Appelez la méthode ConvertHTML avec l’objet MarkdownSaveOptions
  3. Enregistrer le fichier de sortie Markdown (.md)

Le code ci-dessous montre comment convertir une page Web HTML en Markdown à l’aide de C# :

// Préparez un code HTML et enregistrez-le dans le fichier.
var code = "<h1>Header 1</h1>" +
            "<h2>Header 2</h2>" +
            "<p>Hello World!!</p>";
System.IO.File.WriteAllText(dataDir + "document.html", code);

// Appelez la méthode ConvertHTML pour convertir HTML en Markdown.
Aspose.Html.Converters.Converter.ConvertHTML(dataDir + "document.html", new Aspose.Html.Saving.MarkdownSaveOptions(), dataDir + "output.md");

Convertir une page Web HTML en Markdown MD (.md) avec des options supplémentaires en C#

Nous avons déjà appris le cas d’utilisation simple et basique de la conversion de HTML en notation Markdown. Passons une autre étape plus loin où nous contrôlerons le processus de conversion. Considérez un scénario où il y a beaucoup de données non pertinentes dans un fichier HTML mais dont nous avons seulement besoin de convertir le contenu en balises de paragraphe ou de lien hypertexte. Nous suivrons les étapes ci-dessous pour comprendre et essayer cette fonctionnalité :

  1. Charger un fichier HTML d’entrée
  2. Initialiser l’objet MarkdownSaveOptions
  3. Définissez les variables Flag sous la propriété Features
  4. Enregistrer le fichier Markdown de sortie

Le code ci-dessous est basé sur ces étapes qui montrent comment convertir une page Web HTML en Markdown avec des options supplémentaires à l’aide de C# :

// Préparez un code HTML et enregistrez-le dans le fichier.
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);

// Créez une instance de SaveOptions et configurez la règle : 
// - seulement <a>et</a><p> <a>les éléments seront convertis en démarque.</a>
var options = new Aspose.Html.Saving.MarkdownSaveOptions();
options.Features = Aspose.Html.Saving.MarkdownFeatures.Link | Aspose.Html.Saving.MarkdownFeatures.AutomaticParagraph;

// Appelez la méthode ConvertHTML pour convertir le HTML en Markdown.
Aspose.Html.Converters.Converter.ConvertHTML(dataDir + "document.html", options, dataDir + "output_options.md");

Convertir Markdown (.md) en page Web HTML par programmation à l’aide de C#

Vous devrez peut-être convertir HTML en notation Markdown dans certains scénarios. Par exemple, certaines sections de documentation sont utilisées dans les applications Web et dans de nombreux autres cas d’utilisation. Vous pouvez facilement convertir le fichier Markdown en HTML en procédant comme suit :

  1. Créez un fichier Markdown (.md) ou chargez le fichier d’entrée
  2. Enregistrez le fichier HTML de sortie avec la méthode ConvertMarkdown

Le code ci-dessous montre comment convertir un fichier Markdown (.md) en page Web HTML à l’aide du langage de programmation C# :

// Préparez un exemple simple de Markdown
var code = "### Hello World" +
            "\r\n" +
            "[visit applications](https://products.aspose.app/html/family)";
// Créer un fichier Markdown
System.IO.File.WriteAllText(dataDir + "input_document.md", code);

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

Télécharger l’exemple de projet et les fichiers d’exemple

Nous avons compilé un exemple de projet comme démonstration des fonctionnalités susmentionnées où vous pouvez également télécharger les exemples de fichiers. Il s’agit d’une application console que vous pouvez essayer afin d’explorer et de comprendre les fonctionnalités de démarquage et d’inter-conversion HTML. Vous pouvez donc télécharger le ZIP ou cloner le GitHub Repository pour tester les fonctionnalités.

Conclusion

En un mot, nous avons exploré en détail la conversion de pages Web HTML et de fichiers Markdown. L’API peut convertir ces fichiers rapidement et efficacement avec de simples appels d’API. De plus, vous pouvez découvrir d’autres fonctionnalités en visitant Product Documentation et API References. Cependant, en cas de problème, n’hésitez pas à nous contacter via le Forum d’assistance gratuit.

Voir également