Cara Membuat Teks Markdown di C#

Seperti HTML, Markdown adalah bahasa markup. Tidak seperti HTML, Markdown bertujuan agar dapat dibaca sebanyak mungkin. Anda dapat menerapkan huruf tebal, miring, tanda kutip, dan coret ke teks. Mereka juga dapat digunakan dalam kombinasi untuk menggunakan beberapa gaya sekaligus. Pustaka Aspose.HTML for .NET adalah solusi berdiri sendiri yang memungkinkan Anda mengurai dan memanipulasi file Markdown tanpa menggunakan perangkat lunak lain. Anda dapat membuat dokumen Markdown dari awal, membukanya dari file lokal dan memanipulasinya dengan memasukkan elemen baru, dan menghapus, atau mengedit konten node yang ada.

Kelas MarkdownSyntaxFactory berisi metode untuk membuat berbagai elemen Markdown. Untuk pembuatan header, Anda dapat menggunakan metode AtxHeading() yang membuat Atx Heading Syntax Node dengan konten teks. Anda dapat menggunakan metode Emphasis() yang menggunakan enumerasi Penekanan sebagai parameter nilai untuk membuat teks tebal atau miring, dan banyak lagi. Di sini kita melihat beberapa contoh C# tentang cara bekerja dengan teks Markdown.


Teks Markdown dalam C#

Menggunakan pustaka C#, Anda dapat mengedit file MD secara terprogram - mengubah struktur dan konten dokumen. Mari kita lihat membuat dokumen Markdown baru dari awal dan menambahkan teks ke dalamnya.

Kode C# untuk membuat teks Markdown

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

    // Use the SyntaxFactory property to get the factory for creating the Markdown syntax tree
    var mdf = md.SyntaxFactory;

    var header = mdf.AtxHeading("How to create Markdown Text in C#?", 2);    

    // Create and add newLineTrivia element for an empty line after header 
    var newLineTrivia = mdf.NewLineTrivia();
    header.GetTrailingTrivia().Add(newLineTrivia);

    // Add the  headers to the Markdown syntax tree
     md.AppendChild(header);

    // Create an empty paragraph
    var paragraph = mdf.Paragraph();

    // Add texts to the paragraph
    paragraph.AppendChild(mdf.Text("First, add an Aspose.HTML for .NET library reference to your C# project."));

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

    paragraph.AppendChild(mdf.Text("Then create the Markdown Syntax Tree and use the SyntaxFactory property to get a syntax factory to create new elements."));

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

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

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



Langkah-langkah Membuat Teks Markdown di C#

  1. Mari pertimbangkan beberapa langkah sederhana untuk membuat teks Markdown:1. Buat MarkdownSyntaxTree menggunakan konstruktor MarkdownSyntaxTree() .
  2. Gunakan properti SyntaxFactory untuk mendapatkan pabrik untuk membuat pohon sintaks Markdown.
  3. Buat header baru menggunakan AtxHeading(string, int) konstruktor Kelas MarkdownSyntaxFactory . Itu membuat AtxHeadingSyntaxNode dengan konten teks dan tingkat heading.
  4. Buat elemen LineTrivia baru untuk baris kosong setelah header. Gunakan konstruktor NewLineTrivia() .
  5. Panggil metode Add() dari kelas SyntaxNodeCollection untuk menambahkan node newLineTrivia ke dalam elemen header.
  6. Setelah semua node header dikumpulkan menjadi satu elemen, tambahkan ke pohon sintaks dokumen.
  7. Buat simpul paragraf kosong baru menggunakan konstruktor Paragraph() di SyntaxFactory.
  8. Gunakan konstruktor Text() untuk membuat node teks untuk paragraf.
  9. Gunakan konstruktor Whitespace() untuk membuat spasi di antara node teks dalam paragraf.
  10. Panggil metode AppendChild() dari kelas MarkdownSyntaxNode untuk menambahkan node teks dan spasi putih ke dalam paragraf.
  11. Setelah semua simpul paragraf dikumpulkan menjadi satu elemen, tambahkan ke pohon sintaks dokumen. Panggil metode AppendChild() dari kelas MarkdownSyntaxNode.

Buat Markdown Blockquote di C#

Contoh kode C# berikut menunjukkan cara membuat Markdown blockquote.

Kode C# untuk menambahkan blockquote Markdown

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

    // Create a Markdown syntax factory
    var mdf = markdown.SyntaxFactory;

    // Create a blockQuote object
    var blockQuote = mdf.BlockQuote();

    // Add a leading trivia token blockquote
    blockQuote.GetLinesLeadingTrivia().Add(mdf.Token(SourceText.From("> ")));

    // Create a paragraph with text content 
    var paragraph = mdf.Paragraph();
    paragraph.AppendChild(mdf.Text("For blockquote creation, you should put a sign `>` before the first line of a hard-wrapped paragraph.."));

    // Add paragraph into blockQuote
    blockQuote.AppendChild(paragraph);

    // Add blockQuote object into MD document
    markdown.AppendChild(blockQuote);

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

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

Dokumentasi

Untuk mempelajari Aspose.HTML API lebih lanjut, kunjungi dokumentasi panduan kami. Markdown adalah bahasa markup sederhana yang memungkinkan Anda memformat teks biasa. Artikel dokumentasi Markdown Syntax memberikan informasi tentang elemen Markdown utama, detail, dan contoh sintaks Markdown.


FAQ

1. Bagaimana cara membuat, mem-parsing, dan mengedit Markdown di C#?

Perpustakaan Aspose.HTML for .NET adalah solusi yang berdiri sendiri untuk bekerja dengan dokumen Markdown yang tidak bergantung pada perangkat lunak lain. Instal pustaka C# kami, tambahkan referensi pustaka ke proyek C# Anda, dan secara terprogram bekerja dengan dokumen Markdown.

2. Mengapa Markdown begitu populer?

Penurunan harga sangat populer di kalangan penulis, pengembang, dan pembuat konten karena keserbagunaannya. Keuntungannya termasuk sintaks yang mudah dipelajari dan digunakan, portabilitas, fleksibilitas, keterbacaan, dan kegunaan. Penurunan harga sederhana dan intuitif dan dapat dikonversi ke HTML, PDF, atau format lainnya.

3. Bisakah saya bekerja dengan file Markdown di Linux, Mac OS, Android atau iOS?

Anda dapat bekerja dengan dokumen Markdown di sistem operasi apa pun, baik Anda menggunakan Windows, Mac OS, Linux, Android, atau iOS.

4. Format file apa yang dapat diproses dengan pustaka Aspose.HTML C#?

Kami mendukung beberapa format file yang dapat Anda buat, buka, parse, edit, simpan, atau konversi dalam C#. Ini adalah format HTML, XHTML, MHTML dan Markdown.



Mulai dengan .NET HTML API

Anda dapat menggunakan beberapa cara untuk menginstal pustaka Aspose.HTML for .NET di sistem Anda:

  1. Instal Paket NuGet menggunakan GUI Pengelola Paket NuGet.
  2. Instal Paket NuGet menggunakan Package Manager Console. Anda dapat menggunakan perintah berikut PM> Install-Package Aspose.Html.
  3. Instal Aspose.HTML for .NET melalui MSI.

Pustaka ini mendukung penguraian HTML5, CSS3, SVG, dan HTML Canvas untuk membuat Model Objek Dokumen (DOM) berdasarkan Standar DOM WHATWG. Aspose.HTML for .NET ditulis sepenuhnya dalam C# dan dapat digunakan untuk membangun segala jenis aplikasi .NET 32-bit atau 64-bit termasuk ASP.NET, WCF, WinForms & .NET Core. Sebelum menjalankan kode contoh konversi .NET, pastikan Anda memiliki OS seperti Microsoft Windows atau yang kompatibel dengan .NET Framework atau .NET Standard, dan lingkungan pengembangan seperti Microsoft Visual Studio. Untuk detail selengkapnya tentang penginstalan library C# dan persyaratan sistem, lihat Dokumentasi Aspose.HTML.


Persyaratan sistem

API kami didukung di semua platform utama dan Sistem Operasi. Sebelum mengeksekusi kode, harap pastikan bahwa Anda memiliki prasyarat berikut di sistem Anda.

  • Microsoft Windows atau OS yang kompatibel dengan Platform .NET Framework, .NET Core, Windows Azure, Mono atau Xamarin.
  • Lingkungan pengembangan seperti Microsoft Visual Studio.
  • Aspose.HTML for .NET DLL yang direferensikan dalam proyek Anda - Instal dari NuGet menggunakan tombol Unduh di atas.