Paragraph Markdown di C#

Cara Membuat Paragraph Markdown di C#

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, membuka dari file lokal dan memanipulasi dengan memasukkan elemen baru, menghapus, atau mengedit konten node yang ada.
Gunakan Aspose.Html.Toolkit.Markdown.Syntax dan Aspose.Html.Toolkit.Markdown.Parser namespace untuk menyediakan penguraian Markdown penuh dan manajemen pohon sintaks MD berdasarkan spesifikasi GitHub Flavoured Markdown (GFM).

Cara Menambahkan Paragraph Markdown di C#

Menggunakan pustaka C#, Anda dapat mengedit file MD secara terprogram – mengubah struktur dan konten dokumen. Membuat elemen paragraf MD di C# memiliki fitur. Fiturnya adalah paragraf perlu dirangkai dari beberapa simpul, seperti simpul teks, spasi antar simpul teks, dan baris kosong setelah paragraf. Mari kita lihat membuat dokumen Markdown baru dari awal dan menambahkan dua paragraf ke dalamnya.

    // 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;

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

    // Add texts to the paragraph1
    paragraph1.AppendChild(mdf.Text("The first sentence of the first paragraph."));
    // Add a space after the first sentence in the paragraph through a special WhiteSpace node
    paragraph1.AppendChild(mdf.Whitespace());

    paragraph1.AppendChild(mdf.Text("The second sentence of the first paragraph."));

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

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

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

    // Add texts to the paragraph2
    paragraph2.AppendChild(mdf.Text("The first sentence of the second paragraph."));
    // Add a space after the first sentence in the paragraph through a special WhiteSpace node
    paragraph2.AppendChild(mdf.Whitespace());

    paragraph2.AppendChild(mdf.Text("The second sentence of the second paragraph."));

    // Add newLineTrivia element for an empty line after paragraph2
    paragraph2.GetTrailingTrivia().Add(newLineTrivia);

    // Add the filled paragraph2 into MD document as a last child
    md.AppendChild(paragraph2);

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

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

Langkah-langkah Membuat Markdown Paragraph di C#

Kami mengingatkan Anda bahwa paragraf perlu dirakit dari node komponen. Pertimbangkan langkah-langkah sederhana untuk membuat paragraf Markdown:

1. Buat simpul paragraf kosong baru menggunakan konstruktor Paragraph() di SyntaxFactory.
2. Gunakan konstruktor Text() untuk membuat node teks untuk paragraf.
3. Panggil metode AppendChild() dari kelas MarkdownSyntaxNode untuk menambahkan node teks dan spasi putih ke dalam paragraf.
4. Gunakan konstruktor Whitespace() untuk membuat spasi di antara node teks dalam paragraf.
5. Buat dan tambahkan elemen LineTrivia baru untuk baris kosong setelah paragraf. Gunakan konstruktor NewLineTrivia() dan metode Add().
6. Setelah semua simpul paragraf dikumpulkan menjadi satu elemen, tambahkan ke pohon sintaks dokumen.

Tambahkan Paragraph Markdown di C#

Contoh kode C# berikut menunjukkan cara menambahkan paragraf di dokumen MD yang sudah ada:

    // Specify the path to the source MD file
    var input = "C:/temp/input.md";

    // Create a MarkdownParser object
    var parser = new MarkdownParser();

    // Parse the MD document and get a syntax tree
    var syntaxTree = parser.ParseFile(input);

    // Get a SyntaxFactory to create new elements 
    var syntaxFactory = syntaxTree.SyntaxFactory;

    // Create a new empty paragraph 
    var paragraphSyntaxNode = syntaxFactory.Paragraph();

    // Create and add newLineTrivia element for an empty line after paragraph 
    var newLineTrivia = syntaxFactory.NewLineTrivia();
    paragraphSyntaxNode.GetTrailingTrivia().Add(newLineTrivia);
            
    // Create text content for the paragraph 
    var textSyntaxNode = syntaxFactory.Text("Markdown language is simple to learn. It has minimal extra characters, so you can quickly write and make fewer errors.");

    // Add text into paragraph
    paragraphSyntaxNode.AppendChild(textSyntaxNode);

    // Add paragraph to MD document before the first element of the syntax tree
    syntaxTree.InsertBefore(paragraphSyntaxNode, syntaxTree.FirstChild);

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

    // Save Markdown file
    syntaxTree.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

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.