Edit Markdown di C#

Cara Mengedit Markdown di C#

Pustaka Aspose.HTML for .NET adalah solusi mandiri yang memungkinkan Anda mengedit file Markdown tanpa menggunakan perangkat lunak lain. Anda dapat memodifikasi dokumen Markdown dengan memasukkan elemen baru, menghapus, atau mengedit konten node yang ada.
Namespace Aspose.Html.Toolkit.Markdown.Syntax berisi class dan metode untuk memanipulasi pohon sintaks Markdown berdasarkan pada Spesifikasi GitHub Flavoured Markdown (GFM).
Namespace Aspose.Html.Toolkit.Markdown.Parser berisi class dan metode untuk menyediakan penguraian Markdown lengkap dan rendering.
Namespace Aspose.Html.Toolkit.Markdown.Extensions berisi class dan metode untuk memanipulasi pohon sintaks Markdown berdasarkan pada spesifikasi yang bukan bagian dari spesifikasi GFM.
Pengeditan dokumen apa pun yang ingin Anda lakukan melibatkan memuat dokumen MD, mengedit, dan menyimpannya dalam format yang didukung. Ini bisa menjadi skenario yang berbeda, tetapi dapat dibuat dengan beberapa langkah yang diperlukan:

• Buka atau buat Markdown.
• Parse Markdown untuk mendapatkan pohon sintaksis. Edit pohon sintaks Markdown menggunakan kelas dan metode di ruang nama di atas.
• Simpan MD atau konversi MD ke format file yang diperlukan.

Cara Menambahkan Elemen ke File MD di C#

Menggunakan pustaka C#, Anda dapat mengedit file MD secara terprogram – mengubah struktur dan konten dokumen. Contoh kode C# berikut menunjukkan cara menambahkan paragraf baru ke dokumen MD:

    // Specify the path to the source MD file
    var input = @"C:\temp\document.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 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("New paragraph text.");
    paragraphSyntaxNode.AppendChild(textSyntaxNode);

    // Add the paragraph 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-add-paragraph.md");

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

Langkah Membuat dan Menambahkan Elemen ke Dokumen MD di C#

Pertimbangkan langkah-langkah sederhana untuk mengedit dokumen MD yang ada. Dalam dokumen akan menambahkan paragraf teks baru:

1. Tentukan jalur ke file MD sumber dan gunakan MarkdownParser() konstruktor untuk menginisialisasi instance baru dari kelas MarkdownParser.
2. Panggil metode ParseFile() untuk mengurai Markdown dan mendapatkan pohon sintaks.
3. Gunakan properti SyntaxFactory untuk mendapatkan pabrik sintaks untuk membuat elemen baru.
4. Buat paragraf baru menggunakan konstruktor Paragraph(). Buat dan tambahkan konten teks untuk paragraf baru.
5. Gunakan metode InsertBefore() untuk menambahkan paragraf sebelum elemen pertama sintaks pohon.
6. Simpan file MD yang telah diedit dengan metode Save() .

Cara Mengedit Markdown Header di C#

Mari kita lihat cara mengedit elemen pertama di file MD ( document.md ). Elemen pertama dalam file adalah header, level 3. File yang diedit yang Anda temukan mengikuti tautan – output-edit-header.md

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

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

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

    // The first element of this document is AtxHeading
    var heading = (AtxHeadingSyntaxNode)syntaxTree.FirstChild;

    // Accumulate the text content from its elements
    var sb = new StringBuilder();

    while (heading.FirstChild != null)
    {
        sb.Append(heading.FirstChild);

        //  Remove accumulated first element from the tree
        heading.RemoveChild(heading.FirstChild);
    }

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

    // Сreate a text node consisting of new and old text and add it as a child element of AtxHeading 
    var textSyntaxNode = syntaxFactory.Text("Some new text! " + sb);
            
    // Add the new element to the document tree
    heading.AppendChild(textSyntaxNode);

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

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

Dokumentasi

Untuk mempelajari Aspose.HTML API lebih lanjut, kunjungi dokumentasi panduan kami. Anda dapat mendownload contoh dari repositori GitHub . Mereka adalah open source dan dapat digunakan secara bebas di aplikasi Anda sendiri.

Artikel dokumentasi Markdown Syntax memberikan informasi tentang elemen Markdown utama, detail, dan contoh sintaks Markdown.

Markdown adalah bahasa markup sederhana yang memungkinkan Anda memformat teks biasa. File MD menggunakan bahasa Markdown yang diusulkan dan dikembangkan oleh John Gruber. John Gruber merancang sintaks pemformatan Markdown dengan tujuan membuatnya mudah dibaca. Markdown sering digunakan sebagai format untuk file dokumentasi dan readme karena memungkinkan penulisan dengan gaya yang mudah dibaca dan mudah ditulis. Selain itu, file MD dapat dikonversi ke HTML, PDF, XPS, atau gambar untuk memanfaatkan format lain untuk tugas tertentu.

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.