Převést HTML Markdown C#

Markdown je značkovací jazyk s jednoduchými symboly, které označují nadpis, tučné písmo, kurzívu, podtržení a mnoho dalšího. Je snadné se naučit a psát, takže většinou online dokumentace a soubory readme se zapisují pomocí markdown. Markdown můžete snadno převést na webovou stránku HTML pomocí několika rychlých kroků. Stejně tak převod HTML na markdown je také užitečná funkce, kterou zde prozkoumáme pomocí jazyka C#.

Převodník HTML a Markdown – Instalace API

Webovou stránku HTML a soubory formátu Markdown můžete vzájemně převádět pomocí programovacího jazyka C#. Chcete-li manipulovat a převádět tyto formáty souborů, musíte si nainstalovat Aspose.HTML for .NET API. Rozhraní API můžete nainstalovat buď z galerie NuGet pomocí následujícího instalačního příkazu, nebo si můžete stáhnout soubor DLL ze sekce Downloads a přidat jej jako referenci do svého projektu.

PM> Install-Package Aspose.Html

Doposud budete schopni nakonfigurovat API během několika minut. Pojďme si projít různé možné scénáře:

Převést webovou stránku HTML na Markdown (.md) programově v C#

Webovou stránku HTML můžete převést na Markdown ve svých aplikacích založených na .NET. Tato oblíbená konverzní funkce je podporována tak, že stačí volat rozhraní API, aniž byste se dostali do podrobností o základních formátech souborů. Pro konverzi webové stránky HTML proto musíte postupovat podle následujících kroků:

  1. Vytvořte soubor HTML nebo načtěte existující vstupní soubor
  2. Volejte metodu ConvertHTML s objektem MarkdownSaveOptions
  3. Uložit výstupní soubor Markdown (.md).

Níže uvedený kód ukazuje, jak převést HTML webovou stránku na Markdown pomocí C#:

// Připravte si HTML kód a uložte jej do souboru.
var code = "<h1>Header 1</h1>" +
            "<h2>Header 2</h2>" +
            "<p>Hello World!!</p>";
System.IO.File.WriteAllText(dataDir + "document.html", code);

// Chcete-li převést HTML na Markdown, zavolejte metodu ConvertHTML.
Aspose.Html.Converters.Converter.ConvertHTML(dataDir + "document.html", new Aspose.Html.Saving.MarkdownSaveOptions(), dataDir + "output.md");

Převod HTML webové stránky na Markdown MD (.md) s dalšími možnostmi v C#

Již jsme se naučili jednoduchý a základní případ použití převodu HTML do notace Markdown. Posuňme se o další krok dále, kde budeme řídit proces konverze. Zvažte scénář, kdy je v souboru HTML mnoho irelevantních dat, ale potřebujeme pouze převést obsah na značky odstavce nebo hypertextového odkazu. Pro pochopení a vyzkoušení této funkce budeme postupovat podle níže uvedených kroků:

  1. Načtěte vstupní soubor HTML
  2. Inicializujte objekt MarkdownSaveOptions
  3. Nastavte proměnné Flag ve vlastnosti Features
  4. Uložit výstupní soubor Markdown

Níže uvedený kód je založen na těchto krocích, které ukazují, jak převést webovou stránku HTML na Markdown s dalšími možnostmi pomocí C#:

// Připravte si HTML kód a uložte jej do souboru.
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);

// Vytvořte instanci SaveOptions a nastavte pravidlo: 
// - pouze <a>a</a><p> <a>prvky budou převedeny na markdown.</a>
var options = new Aspose.Html.Saving.MarkdownSaveOptions();
options.Features = Aspose.Html.Saving.MarkdownFeatures.Link | Aspose.Html.Saving.MarkdownFeatures.AutomaticParagraph;

// Chcete-li převést HTML na Markdown, zavolejte metodu ConvertHTML.
Aspose.Html.Converters.Converter.ConvertHTML(dataDir + "document.html", options, dataDir + "output_options.md");

Převést Markdown (.md) na HTML webovou stránku programově pomocí C#

V některých scénářích může být nutné převést HTML na zápis Markdown. Některé sekce dokumentace jsou například využívány ve webových aplikacích a mnoha dalších případech použití. Soubor Markdown můžete snadno převést do HTML pomocí následujících kroků:

  1. Vytvořte soubor Markdown (.md) nebo načtěte vstupní soubor
  2. Uložte výstupní soubor HTML pomocí metody ConvertMarkdown

Níže uvedený kód ukazuje, jak převést soubor Markdown (.md) na webovou stránku HTML pomocí programovacího jazyka C#:

// Připravte si jednoduchý příklad Markdown
var code = "### Hello World" +
            "\r\n" +
            "[visit applications](https://products.aspose.app/html/family)";
// Vytvořte soubor Markdown
System.IO.File.WriteAllText(dataDir + "input_document.md", code);

// Převést Markdown na HTML dokument
Aspose.Html.Converters.Converter.ConvertMarkdown(dataDir + "input_document.md", dataDir + "MarkdownToHTMLoutput.html");

Stáhněte si ukázkový projekt a ukázkové soubory

Jako ukázku výše uvedených funkcí jsme sestavili ukázkový projekt, kde si také můžete stáhnout ukázkové soubory. Je to konzolová aplikace, kterou si můžete vyzkoušet, abyste prozkoumali a porozuměli funkcím markdown a HTML inter-conversion. Můžete si tedy stáhnout ZIP nebo naklonovat GitHub Repository pro testování funkcí.

Závěr

Stručně řečeno, podrobně jsme prozkoumali převod HTML webových stránek a souborů Markdown. Rozhraní API dokáže tyto soubory rychle a efektivně převést pomocí jednoduchých volání API. Kromě toho se můžete dozvědět o dalších funkcích na stránkách Product Documentation a API Reference. V případě jakýchkoliv obav nás však neváhejte kontaktovat prostřednictvím Free Support Forum.

Viz také