Image dans Markdown via C#
Les images peuvent être ajoutées à n’importe quel fichier Markdown à l’aide de la syntaxe Markdown. Dans cet article, vous apprendrez à ajouter des images dans Markdown, à afficher des images sous forme de liens et à ajouter altText aux images Markdown à l’aide de C#. La bibliothèque
Aspose.HTML for .NET
est une solution autonome qui vous permet d’analyser et de manipuler des fichiers Markdown sans utiliser d’autres logiciels. Vous pouvez créer un document Markdown à partir de zéro, l’ouvrir à partir d’un fichier local et le manipuler en insérant de nouveaux éléments, en supprimant ou en modifiant le contenu des nœuds existants.
Utilisez les espaces de noms
Aspose.Html.Toolkit.Markdown.Syntax
et
Aspose.Html.Toolkit.Markdown.Parser
pour fournir une analyse complète de Markdown et une gestion de l’arborescence de syntaxe MD basée sur GitHub Flavored Markdown (GFM ) spécification.
Comment ajouter une image dans Markdown à l'aide de C#
À l’aide de la bibliothèque C#, vous pouvez modifier par programmation des fichiers MD – modifier la structure et le contenu du document. Regardons comment créer un nouveau document Markdown à partir de zéro et y ajouter une image.
Code C# pour ajouter une image au fichier 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);
Étapes pour ajouter une image au fichier MD en C#
Quelques étapes simples pour créer une image Markdown :
- Créez le MarkdownSyntaxTree à l’aide du constructeur MarkdownSyntaxTree() .
- Utilisez la propriété SyntaxFactory pour obtenir la fabrique permettant de créer l’arbre de syntaxe Markdown.
- Spécifiez une image altText, une étiquette et un chemin d’accès à l’image et transmettez-les à InlineImage().
- Créez un élément Image à l’aide du constructeur InlineImage() dans SyntaxFactory.
- Appelez la méthode AppendChild() de la classe MarkdownSyntaxNode pour ajouter l’image dans l’arborescence de syntaxe MD.
Ajouter une image Markdown en tant que lien en C#
L’exemple de code C# suivant montre comment ajouter une image en tant que lien dans un document MD :
Code C# pour créer une image Markdown en tant que lien
// 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);
Documentation
Pour en savoir plus sur l’API Aspose.HTML, veuillez consulter notre
documentation
guide. Markdown est un langage de balisage simple qui vous permet de formater du texte brut. L’article de documentation
Markdown Syntax
fournit des informations sur les principaux éléments Markdown, des détails et des exemples de la syntaxe Markdown.
Démarrer avec l'API Aspose.HTML for .NET
Vous pouvez utiliser plusieurs méthodes pour installer la bibliothèque Aspose.HTML for .NET sur votre système :
- Installez un package NuGet à l’aide de l’interface graphique du gestionnaire de packages NuGet.
- Installez un package NuGet à l’aide de la console du gestionnaire de packages. Vous pouvez utiliser la commande suivante
PM> Install-Package Aspose.Html
. - Installez Aspose.HTML for .NET via MSI.
Cette bibliothèque prend en charge l’analyse de HTML5, CSS3, SVG et HTML Canvas pour construire un modèle d’objet de document (DOM) basé sur la norme WHATWG DOM. Aspose.HTML for .NET est entièrement écrit en C# et peut être utilisé pour créer tout type d’application .NET 32 bits ou 64 bits, y compris ASP.NET, WCF, WinForms et .NET Core. Avant d’exécuter l’exemple de code de conversion .NET, assurez-vous que vous disposez d’un système d’exploitation tel que Microsoft Windows ou compatible avec .NET Framework ou .NET Standard, et d’un environnement de développement tel que Microsoft Visual Studio. Pour plus de détails sur l’installation de la bibliothèque C# et la configuration système requise, veuillez consulter Aspose.HTML Documentation.
Configuration requise
Nos API sont prises en charge sur toutes les principales plates-formes et systèmes d’exploitation. Avant d’exécuter le code, assurez-vous que vous disposez des prérequis suivants sur votre système.
- Microsoft Windows ou un système d’exploitation compatible avec les plates-formes .NET Framework, .NET Core, Windows Azure, Mono ou Xamarin.
- Environnement de développement comme Microsoft Visual Studio.
- Aspose.HTML for .NET DLL référencé dans votre projet – Installez à partir de NuGet en utilisant le bouton Télécharger ci-dessus.