Modifier des documents HTML et Markdown en C#

API d’édition de documents pour les applications C#

Aspose.HTML for .NET fournit des API structurées pour modifier le contenu HTML et Markdown. Utilisez un HTMLDocument pour modifier le DOM HTML, ou analysez Markdown sous forme d’arbre syntaxique typé avant de mettre à jour ses nœuds. Après la modification, enregistrez le document dans son format éditable ou transmettez-le à un flux distinct d’archivage ou de conversion.

Choisir un flux d’édition HTML ou Markdown

• Modification de documents HTML . Chargez un fichier HTML, une URL, une chaîne ou un flux, localisez les éléments DOM, modifiez le texte, les attributs, les styles ou la structure du document, puis enregistrez le HTML modifié.
• Modification de fichiers Markdown . Analysez un fichier MD existant sous forme d’AST typé, mettez à jour les titres, paragraphes, listes, liens ou autres nœuds syntaxiques, puis sérialisez de nouveau l’arbre modifié en Markdown.
• Flux HTML vers MHTML . Modifiez d’abord le HTML, puis regroupez le document modifié et les ressources traitées dans une archive MHTML. Les archives MHTML et MHT existantes servent d’entrées de rendu ou de conversion, et non de sources pour un DOM HTML éditable.

Mettre à jour les métadonnées d’une page HTML en C#

Cet exemple charge un document HTML, met à jour le titre de la page et la métadescription, crée les éléments de métadonnées manquants si nécessaire, puis enregistre le fichier modifié. Le flux Markdown utilise une API distincte fondée sur un arbre syntaxique typé.

using Aspose.Html;
using Aspose.Html.Dom;

using HTMLDocument document = new HTMLDocument("input.html");

// Update the document title through the HTMLDocument API
document.Title = "Updated page title";

// Find the head and create the description element when it is missing
Element head = document.QuerySelector("head");
if (head != null)
{
    Element description = document.QuerySelector("meta[name='description']");
    if (description == null)
    {
        description = document.CreateElement("meta");
        description.SetAttribute("name", "description");
        head.AppendChild(description);
    }

    description.SetAttribute("content", "Updated page description.");
}

document.Save("edited.html");

Étapes principales pour modifier du HTML

1. Chargez la source avec un constructeur HTMLDocument .
2. Localisez l’élément requis avec QuerySelector() , GetElementById(), XPath ou une autre méthode de navigation dans le DOM.
3. Mettez à jour le texte, les attributs, les styles ou les nœuds enfants avec l’API DOM.
4. Appelez Save() pour écrire du HTML, ou poursuivez avec un flux dédié de conversion ou de création d’archive MHTML.

Contenu modifiable par programmation

• Structure du document. Ajoutez, remplacez, déplacez ou supprimez des nœuds du DOM HTML et des nœuds syntaxiques Markdown pris en charge.
• Texte et balisage. Mettez à jour le texte brut, le balisage HTML, les titres, les paragraphes, les listes, les liens, les blocs de code et d’autres contenus structurés.
• Attributs HTML et CSS. Modifiez les attributs des éléments, les styles en ligne, le contenu de <style> et les références aux feuilles de style.
• Nœuds sélectionnés. Recherchez des éléments HTML avec des sélecteurs CSS ou des requêtes XPath , et parcourez Markdown à l’aide de nœuds AST typés.
• Flux de sortie. Enregistrez du HTML ou du Markdown éditable, créez un fichier MHTML à partir du HTML modifié ou transmettez le contenu préparé à une API de conversion lorsque le résultat final doit être un PDF, un DOCX, un XPS ou une image.

Documentation sur l’édition de documents

Le guide Edit HTML Document explique la modification des nœuds DOM, des attributs, du texte et du balisage. Consultez Edit and Modify Markdown pour des exemples utilisant l’AST Markdown typé. La section Working with HTML Documents décrit le chargement, la modification, la configuration de l’environnement, l’enregistrement et le traitement des ressources.

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.

Questions sur l’édition de HTML, Markdown et MHTML

1. Comment modifier un fichier HTML en C# ?

Chargez le fichier dans un HTMLDocument, recherchez les éléments DOM requis avec QuerySelector(), GetElementById(), XPath ou le parcours du DOM, mettez à jour leur texte, leurs attributs, leurs styles ou leurs nœuds enfants, puis appelez Save() pour écrire le HTML modifié.

2. Faut-il modifier Markdown directement ou le convertir d’abord en HTML ?

Modifiez directement le MarkdownSyntaxTree lorsque le résultat doit rester un fichier MD. Convertissez d’abord Markdown en HTML lorsque le flux exige des opérations sur le DOM HTML, un balisage destiné au navigateur ou une sortie rendue plutôt qu’un code source Markdown mis à jour.

3. Peut-on modifier un fichier MHTML existant en C# ?

Une archive MHTML ou MHT existante n’est pas chargée comme un HTMLDocument éditable. Modifiez le HTML d’origine et créez une nouvelle archive MHTML à partir du document mis à jour. Utilisez le flux de conversion lorsque seule l’archive MHTML est disponible.