Konwertuj HTML Markdown C#

Markdown to język znaczników z prostymi symbolami oznaczającymi nagłówek, pogrubienie, kursywę, podkreślenie i wiele więcej. Jest łatwy do nauczenia się i pisania, więc większość dokumentacji online i plików readme jest pisana przy użyciu przeceny. Możesz łatwo przekonwertować przecenę na stronę HTML w kilku szybkich krokach. Podobnie konwersja kodu HTML na przecenę jest również przydatną funkcją, którą będziemy omawiać tutaj przy użyciu języka C#.

Konwerter HTML i Markdown – instalacja API

Możesz konwertować strony internetowe HTML i pliki w formacie Markdown przy użyciu języka programowania C#. Musisz zainstalować Aspose.HTML for .NET API, aby manipulować i konwertować te formaty plików. Możesz zainstalować interfejs API z galerii NuGet za pomocą następującego polecenia instalacji lub pobrać plik DLL z sekcji Downloads, aby dodać go jako odniesienie do swojego projektu.

PM> Install-Package Aspose.Html

Do tej pory będziesz mógł skonfigurować API w ciągu kilku minut. Przejdźmy do omówienia różnych możliwych scenariuszy:

Konwertuj stronę internetową HTML na Markdown (.md) Programowo w C#

Możesz przekonwertować stronę internetową HTML na Markdown w aplikacjach opartych na platformie .NET. Ta popularna funkcja konwersji jest obsługiwana w taki sposób, że wystarczy wywołać interfejs API bez wchodzenia w szczegóły podstawowych formatów plików. Dlatego musisz wykonać poniższe kroki, aby przekonwertować stronę HTML:

  1. Utwórz plik HTML lub załaduj istniejący plik wejściowy
  2. Wywołaj metodę ConvertHTML z obiektem MarkdownSaveOptions.
  3. Zapisz wyjściowy plik Markdown (.md).

Poniższy kod pokazuje, jak przekonwertować HTML Webpage na Markdown przy użyciu C#:

// Przygotuj kod HTML i zapisz go w pliku.
var code = "<h1>Header 1</h1>" +
            "<h2>Header 2</h2>" +
            "<p>Hello World!!</p>";
System.IO.File.WriteAllText(dataDir + "document.html", code);

// Wywołaj metodę ConvertHTML, aby przekonwertować HTML na Markdown.
Aspose.Html.Converters.Converter.ConvertHTML(dataDir + "document.html", new Aspose.Html.Saving.MarkdownSaveOptions(), dataDir + "output.md");

Konwertuj stronę internetową HTML na Markdown MD (.md) z dodatkowymi opcjami w C#

Poznaliśmy już prosty i podstawowy przypadek użycia konwersji HTML na notację Markdown. Przejdźmy o krok dalej, gdzie będziemy kontrolować proces konwersji. Rozważmy scenariusz, w którym w pliku HTML znajduje się wiele nieistotnych danych, ale musimy tylko przekonwertować zawartość na znaczniki akapitu lub hiperłącza. Wykonamy poniższe kroki, aby zrozumieć i wypróbować tę funkcję:

  1. Załaduj wejściowy plik HTML
  2. Zainicjuj obiekt MarkdownSaveOptions.
  3. Ustaw zmienne Flaga we właściwości Funkcje
  4. Zapisz wyjściowy plik Markdown

Poniższy kod jest oparty na tych krokach, które pokazują, jak przekonwertować HTML Webpage na Markdown z dodatkowymi opcjami przy użyciu C#:

// Przygotuj kod HTML i zapisz go w pliku.
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);

// Utwórz instancję SaveOptions i skonfiguruj regułę: 
// - tylko <a>i</a><p> <a>elementy zostaną przekonwertowane na markdown.</a>
var options = new Aspose.Html.Saving.MarkdownSaveOptions();
options.Features = Aspose.Html.Saving.MarkdownFeatures.Link | Aspose.Html.Saving.MarkdownFeatures.AutomaticParagraph;

// Wywołaj metodę ConvertHTML, aby przekonwertować kod HTML na Markdown.
Aspose.Html.Converters.Converter.ConvertHTML(dataDir + "document.html", options, dataDir + "output_options.md");

Konwertuj Markdown (.md) na stronę HTML Programowo przy użyciu C#

W niektórych scenariuszach może być konieczne przekonwertowanie formatu HTML na notację Markdown. Na przykład niektóre sekcje dokumentacji są wykorzystywane w aplikacjach internetowych i wielu innych przypadkach użycia. Możesz łatwo przekonwertować plik Markdown na HTML, wykonując następujące czynności:

  1. Utwórz plik Markdown (.md) lub załaduj plik wejściowy
  2. Zapisz wyjściowy plik HTML metodą ConvertMarkdown.

Poniższy kod pokazuje, jak przekonwertować plik Markdown (.md) na stronę internetową HTML przy użyciu języka programowania C#:

// Przygotuj prosty przykład Markdown
var code = "### Hello World" +
            "\r\n" +
            "[visit applications](https://products.aspose.app/html/family)";
// Utwórz plik Markdown
System.IO.File.WriteAllText(dataDir + "input_document.md", code);

// Konwertuj Markdown na dokument HTML
Aspose.Html.Converters.Converter.ConvertMarkdown(dataDir + "input_document.md", dataDir + "MarkdownToHTMLoutput.html");

Pobierz przykładowy projekt i przykładowe pliki

Opracowaliśmy przykładowy projekt jako demonstrację wyżej wymienionych funkcji, w którym można również pobrać przykładowe pliki. Jest to aplikacja konsolowa, którą możesz wypróbować, aby poznać i zrozumieć funkcje przeceny i konwersji HTML. Możesz więc pobrać ZIP lub sklonować GitHub Repository w celu przetestowania funkcji.

Wniosek

W skrócie, szczegółowo zbadaliśmy konwersję plików HTML Webpage i Markdown. Interfejs API może szybko i wydajnie konwertować te pliki za pomocą prostych wywołań interfejsu API. Ponadto możesz zapoznać się z innymi funkcjami, odwiedzając Dokumentację produktu i Materiały referencyjne interfejsu API. Jednak w przypadku jakichkolwiek wątpliwości prosimy o kontakt z nami za pośrednictwem Bezpłatnego forum wsparcia.

Zobacz też