Enregistrer MD en C#

Comment enregistrer MD en C#

Markdown est un langage de balisage simple qui vous permet de formater du texte brut. 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 à partir de zéro ou ouvrir un document Markdown à partir d’un fichier local, modifier le contenu des nœuds existants et enregistrer ou convertir le document modifié au format requis.
L’espace de noms Aspose.Html.Toolkit.Markdown.Syntax contient des classes et des méthodes pour manipuler un arbre de syntaxe Markdown basé sur la spécification GitHub Flavored Markdown (GFM).
L’espace de noms Aspose.Html.Toolkit.Markdown.Parser contient des classes et des méthodes pour fournir une analyse et un rendu Markdown complets.
L’espace de noms Aspose.Html.Toolkit.Markdown.Extensions contient des classes et des méthodes pour manipuler l’arbre de syntaxe Markdown en fonction de spécifications qui ne font pas partie de la spécification GFM.

Comment enregistrer un fichier MD en C# ?

L’exemple de code C# suivant montre comment enregistrer un document MD. Les deux dernières étapes sont nécessaires pour enregistrer Markdown – vous pouvez préparer un chemin pour enregistrer le fichier MD et utiliser la méthode Save().

    // Specify the path to the source MD file
    var input = "C:/temp/document.md";

    // Create a MarkdownParser object
    var parser = new MarkdownParser();

    // Parse the MD document and get a syntax tree
    var markdown = parser.ParseFile(input);

    // Work with the Markdown document

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

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

Étapes pour enregistrer MD en C#

Jetons un coup d’œil aux étapes simples pour enregistrer le fichier MD après l’édition:

1. Spécifiez un chemin vers le fichier MD source et utilisez le constructeur MarkdownParser() pour initialiser une nouvelle instance de la classe MarkdownParser.
2. Appelez la méthode ParseFile() pour analyser Markdown et obtenir un arbre de syntaxe.
3. Utilisez la propriété SyntaxFactory pour obtenir une fabrique de syntaxe pour créer de nouveaux éléments.
4. Travaillez avec le document.
5. Préparez le chemin pour enregistrer le fichier MD.
6. Enregistrez le fichier MD créé en utilisant la méthode Save() .

Créer à partir de zéro et enregistrer MD en C#

À l’aide de la bibliothèque C#, vous pouvez créer, modifier et enregistrer par programmation des fichiers MD. Voyons comment enregistrer un fichier MD créé à partir de zéro.

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

    // Create a Markdown syntax factory
    var mdf = md.SyntaxFactory;
            
    // Create an empty paragraph
    var paragraph = mdf.Paragraph();

    // Add texts to the paragraph
    paragraph.AppendChild(mdf.Text("Markdown is a simple markup language that allows you to format plain text."));

    // Add a space after the first sentence in the paragraph through a special WhiteSpace node
    paragraph.AppendChild(mdf.Whitespace());

    paragraph.AppendChild(mdf.Text("MD files use Markdown language that was proposed and developed by John Gruber."));

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

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

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

Documentation

Pour en savoir plus sur l’API Aspose.HTML, veuillez consulter notre documentation guide. 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.

Les fichiers MD utilisent le langage Markdown qui a été proposé et développé par John Gruber. John Gruber a conçu la syntaxe de formatage de Markdown dans le but de la rendre aussi lisible que possible. Markdown est souvent utilisé comme format pour la documentation et les fichiers readme car il permet d’écrire dans un style facile à lire et à écrire. De plus, les fichiers MD peuvent être convertis en HTML, PDF, XPS ou images pour tirer parti d’autres formats pour des tâches spécifiques.

Installer Aspose.HTML for .NET

Installez Aspose.HTML for .NET depuis NuGet avec l’interface CLI .NET :

dotnet add package Aspose.HTML

Vous pouvez également utiliser l’interface du gestionnaire de packages NuGet ou exécuter Install-Package Aspose.HTML dans la console du gestionnaire de packages. Consultez le guide d’installation pour la configuration, ou demandez une licence temporaire afin d’évaluer l’API sans limitations.

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.