แก้ไข Markdown ใน C#

วิธีแก้ไข Markdown ใน C#

ไลบรารี Aspose.HTML สำหรับ .NET เป็นโซลูชันแบบสแตนด์อโลนที่ให้คุณแก้ไขไฟล์ Markdown โดยไม่ต้องใช้ซอฟต์แวร์อื่น คุณสามารถแก้ไขเอกสาร Markdown ได้โดยการแทรกองค์ประกอบใหม่ ลบ หรือแก้ไขเนื้อหาของโหนดที่มีอยู่
เนมสเปซ Aspose.Html.Toolkit.Markdown.Syntax มีคลาสและเมธอดในการจัดการแผนผังไวยากรณ์ Markdown ตามข้อกำหนดของ GitHub Flavoured Markdown (GFM)
เนมสเปซ Aspose.Html.Toolkit.Markdown.Parser มีคลาสและเมธอดเพื่อให้การแยกวิเคราะห์และการแสดงผล Markdown แบบเต็ม
เนมสเปซ Aspose.Html.Toolkit.Markdown.Extensions มีคลาสและวิธีการจัดการแผนผังไวยากรณ์ Markdown ตามข้อกำหนดที่ไม่ได้เป็นส่วนหนึ่งของข้อกำหนด GFM
การแก้ไขเอกสารใด ๆ ที่คุณต้องการดำเนินการเกี่ยวข้องกับการโหลดเอกสาร MD แก้ไขและบันทึกในรูปแบบที่รองรับ อาจเป็นสถานการณ์ที่แตกต่างกัน แต่สามารถทำได้ด้วยขั้นตอนที่จำเป็นสองสามขั้นตอน:

• เปิดหรือ สร้าง Markdown
• แยกวิเคราะห์ Markdown เพื่อรับโครงสร้างไวยากรณ์ แก้ไขโครงสร้างไวยากรณ์ของ Markdown โดยใช้คลาสและเมธอดในเนมสเปซด้านบน
• บันทึก MD หรือ แปลง MD เป็นรูปแบบไฟล์ที่ต้องการ

วิธีเพิ่มองค์ประกอบในไฟล์ MD ใน C#

การใช้ไลบรารี C# คุณสามารถแก้ไขไฟล์ MD โดยทางโปรแกรม – เปลี่ยนโครงสร้างเอกสารและเนื้อหา ตัวอย่างโค้ด C# ต่อไปนี้แสดงวิธีเพิ่มย่อหน้าใหม่ในเอกสาร 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);

ขั้นตอนในการสร้างและเพิ่มองค์ประกอบให้กับเอกสาร MD ใน C#

พิจารณาขั้นตอนง่ายๆ ในการแก้ไขเอกสาร MD ที่มีอยู่ ในเอกสารจะเพิ่มย่อหน้าข้อความใหม่:

1. ระบุเส้นทางไปยังไฟล์ MD ต้นทางและใช้ตัวสร้าง MarkdownParser() เพื่อเริ่มต้นอินสแตนซ์ใหม่ของคลาส MarkdownParser
2. เรียกเมธอด ParseFile() เพื่อแยกวิเคราะห์ Markdown และรับโครงสร้างไวยากรณ์
3. ใช้คุณสมบัติ SyntaxFactory เพื่อรับโรงงานไวยากรณ์เพื่อสร้างองค์ประกอบใหม่
4. สร้างย่อหน้าใหม่โดยใช้ตัวสร้าง Paragraph() สร้างและเพิ่มเนื้อหาข้อความสำหรับย่อหน้าใหม่
5. ใช้เมธอด InsertBefore() เพื่อเพิ่มย่อหน้าก่อนองค์ประกอบแรกของแผนผังไวยากรณ์
6. บันทึกไฟล์ MD ที่แก้ไขด้วยวิธี Save()

วิธีแก้ไข Markdown Header ใน C#

มาดูวิธีแก้ไของค์ประกอบแรกในไฟล์ MD ( document.md ) องค์ประกอบแรกในไฟล์คือส่วนหัว ระดับ 3 ไฟล์ที่แก้ไขแล้วคุณจะพบตามลิงก์ – 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);

เอกสาร

หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับ Aspose.HTML API โปรดไปที่คู่มือ เอกสาร ของเรา คุณสามารถดาวน์โหลดตัวอย่างได้จากที่เก็บ GitHub เป็นโอเพ่นซอร์สและสามารถใช้ได้อย่างอิสระในแอปพลิเคชันของคุณเอง

บทความเอกสาร Markdown Syntax ให้ข้อมูลเกี่ยวกับองค์ประกอบหลักของ Markdown รายละเอียดและตัวอย่างของไวยากรณ์ Markdown

Markdown เป็นภาษามาร์กอัปอย่างง่ายที่ให้คุณจัดรูปแบบข้อความธรรมดาได้ ไฟล์ MD ใช้ภาษา Markdown ที่เสนอและพัฒนาโดย John Gruber John Gruber ออกแบบไวยากรณ์การจัดรูปแบบของ Markdown โดยมีเป้าหมายเพื่อให้อ่านง่ายที่สุด Markdown มักใช้เป็นรูปแบบสำหรับเอกสารประกอบและไฟล์ readme เนื่องจากช่วยให้เขียนในรูปแบบที่อ่านง่ายและเขียนง่าย นอกจากนี้ยังสามารถแปลงไฟล์ MD เป็น HTML, PDF, XPS หรือรูปภาพเพื่อใช้ประโยชน์จากรูปแบบอื่นสำหรับงานเฉพาะ

คำถามที่พบบ่อย

เริ่มต้นใช้งาน .NET HTML API

คุณสามารถใช้หลายวิธีในการติดตั้งไลบรารี Aspose.HTML สำหรับ .NET บนระบบของคุณ:

1. ติดตั้ง NuGet Package โดยใช้ NuGet Package Manager GUI
2. ติดตั้ง NuGet Package โดยใช้ Package Manager Console คุณสามารถใช้คำสั่งต่อไปนี้ PM> Install-Package Aspose.Html
3. ติดตั้ง Aspose.HTML สำหรับ .NET ผ่าน MSI
   

ไลบรารีนี้รองรับการแยกวิเคราะห์ HTML5, CSS3, SVG และ HTML Canvas เพื่อสร้าง Document Object Model (DOM) ตามมาตรฐาน WHATWG DOM Aspose.HTML สำหรับ .NET เขียนขึ้นอย่างสมบูรณ์ในภาษา C# และสามารถใช้สร้างแอปพลิเคชัน .NET แบบ 32 บิตหรือ 64 บิตประเภทใดก็ได้ รวมถึง ASP.NET, WCF, WinForms & .NET Core ก่อนเรียกใช้โค้ดตัวอย่างการแปลง .NET ตรวจสอบให้แน่ใจว่าคุณมีระบบปฏิบัติการ เช่น Microsoft Windows หรือเข้ากันได้กับ .NET Framework หรือ .NET Standard และสภาพแวดล้อมการพัฒนา เช่น Microsoft Visual Studio สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับการติดตั้งไลบรารี C# และข้อกำหนดของระบบ โปรดดูที่ เอกสาร Aspose.HTML