Markdown è un linguaggio di marcatura con simboli semplici che indicano intestazione, grassetto, corsivo, sottolineato e molto altro. È semplice da imparare e scrivere, quindi la maggior parte della documentazione online e dei file readme vengono scritti utilizzando il markdown. Puoi convertire facilmente il markdown in una pagina Web HTML con pochi rapidi passaggi. Allo stesso modo, anche la conversione da HTML a markdown è una funzionalità utile che esploreremo qui utilizzando il linguaggio C#.
- Convertitore HTML e Markdown – Installazione API
- Converti la pagina Web HTML in Markdown a livello di codice in C#
- Converti HTML in Markdown con opzioni aggiuntive in C#
- Converti Markdown in pagina Web HTML in modo programmatico utilizzando C#
Convertitore HTML e Markdown – Installazione API
È possibile convertire la pagina Web HTML e i file in formato Markdown utilizzando il linguaggio di programmazione C#. È necessario installare l’API Aspose.HTML for .NET per manipolare e convertire questi formati di file. Puoi installare l’API dalla galleria NuGet con il seguente comando di installazione oppure puoi scaricare il file DLL dalla sezione Downloads, per aggiungerlo come riferimento nel tuo progetto.
PM> Install-Package Aspose.Html
Finora sarai in grado di configurare l’API in un paio di minuti. Procediamo a camminare attraverso diversi possibili scenari:
Converti la pagina Web HTML in Markdown (.md) a livello di codice in C#
Puoi convertire la pagina Web HTML in Markdown nelle tue applicazioni basate su .NET. Questa popolare funzione di conversione è supportata in modo tale che devi solo chiamare l’API senza entrare nei dettagli dei formati di file sottostanti. Pertanto, è necessario seguire i passaggi seguenti per la conversione della pagina Web HTML:
- Crea un file HTML o carica il file di input esistente
- Chiama il metodo ConvertHTML con l’oggetto MarkdownSaveOptions.
- Salva output Markdown (.md) File
Il codice seguente mostra come convertire una pagina Web HTML in Markdown utilizzando C#:
// Prepara un codice HTML e salvalo nel file.
var code = "<h1>Header 1</h1>" +
"<h2>Header 2</h2>" +
"<p>Hello World!!</p>";
System.IO.File.WriteAllText(dataDir + "document.html", code);
// Chiama il metodo ConvertHTML per convertire HTML in Markdown.
Aspose.Html.Converters.Converter.ConvertHTML(dataDir + "document.html", new Aspose.Html.Saving.MarkdownSaveOptions(), dataDir + "output.md");
Converti la pagina Web HTML in Markdown MD (.md) con opzioni aggiuntive in C#
Abbiamo già imparato il caso d’uso semplice e di base della conversione dell’HTML in notazione Markdown. Facciamo un altro passo avanti dove controlleremo il processo di conversione. Considera uno scenario in cui ci sono molti dati irrilevanti in un file HTML ma dobbiamo solo convertire i contenuti in tag di paragrafo o collegamento ipertestuale. Seguiremo i passaggi seguenti per comprendere e provare questa funzione:
- Carica un file HTML di input
- Inizializza l’oggetto MarkdownSaveOptions.
- Impostare le variabili Flag nella proprietà Features
- Salva il file Markdown di output
Il codice seguente si basa su questi passaggi che mostrano come convertire una pagina Web HTML in Markdown con opzioni aggiuntive utilizzando C#:
// Prepara un codice HTML e salvalo nel file.
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);
// Crea un'istanza di SaveOptions e imposta la regola:
// - solo <a>e</a><p> <a>gli elementi verranno convertiti in markdown.</a>
var options = new Aspose.Html.Saving.MarkdownSaveOptions();
options.Features = Aspose.Html.Saving.MarkdownFeatures.Link | Aspose.Html.Saving.MarkdownFeatures.AutomaticParagraph;
// Chiama il metodo ConvertHTML per convertire l'HTML in Markdown.
Aspose.Html.Converters.Converter.ConvertHTML(dataDir + "document.html", options, dataDir + "output_options.md");
Converti Markdown (.md) in pagina Web HTML in modo programmatico utilizzando C#
Potrebbe essere necessario convertire HTML in notazione Markdown in alcuni scenari. Ad esempio, alcune sezioni della documentazione sono utilizzate nelle applicazioni Web e in molti altri casi d’uso. Puoi convertire facilmente il file Markdown in HTML con i seguenti passaggi:
- Crea un file Markdown (.md) o carica il file di input
- Salva il file HTML di output con il metodo ConvertMarkdown.
Il codice seguente mostra come convertire un file Markdown (.md) in una pagina Web HTML utilizzando il linguaggio di programmazione C#:
// Prepara un semplice esempio di Markdown
var code = "### Hello World" +
"\r\n" +
"[visit applications](https://products.aspose.app/html/family)";
// Crea un file Markdown
System.IO.File.WriteAllText(dataDir + "input_document.md", code);
// Converti Markdown in documento HTML
Aspose.Html.Converters.Converter.ConvertMarkdown(dataDir + "input_document.md", dataDir + "MarkdownToHTMLoutput.html");
Scarica progetto di esempio e file di esempio
Abbiamo compilato un progetto di esempio a dimostrazione delle suddette funzionalità in cui è anche possibile scaricare i file di esempio. È un’applicazione console che puoi provare per esplorare e comprendere le funzionalità di markdown e inter-conversione HTML. Quindi puoi scaricare lo ZIP o clonare il GitHub Repository per testare le funzionalità.
Conclusione
In poche parole, abbiamo esplorato in dettaglio la conversione di pagine Web HTML e file Markdown. L’API può convertire questi file in modo rapido ed efficiente con semplici chiamate API. Inoltre, puoi conoscere altre funzionalità visitando Documentazione del prodotto e Riferimenti API. Tuttavia, in caso di dubbi, non esitare a contattarci tramite il Forum di supporto gratuito.