วิธีสร้างย่อหน้า Markdown ใน C#

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


วิธีเพิ่มย่อหน้า Markdown ใน C#

การใช้ไลบรารี C# คุณสามารถแก้ไขไฟล์ MD โดยทางโปรแกรม – เปลี่ยนโครงสร้างเอกสารและเนื้อหา การสร้างองค์ประกอบย่อหน้า MD ใน C# มีคุณสมบัติ คุณลักษณะคือย่อหน้าจำเป็นต้องประกอบจากหลายโหนด เช่น โหนดข้อความ ช่องว่างระหว่างโหนดข้อความ และบรรทัดว่างหลังย่อหน้า มาดูการสร้างเอกสาร Markdown ใหม่ตั้งแต่ต้นและเพิ่มสองย่อหน้าเข้าไป

รหัส C# เพื่อแก้ไขไฟล์ MD

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



ขั้นตอนในการสร้าง Markdown Paragraph ใน C#

เราเตือนคุณว่าต้องประกอบย่อหน้าจากโหนดคอมโพเนนต์ พิจารณาขั้นตอนง่ายๆ ในการสร้างย่อหน้า Markdown:

  1. สร้างโหนดย่อหน้าว่างใหม่โดยใช้ตัวสร้าง Paragraph() ใน SyntaxFactory
  2. ใช้ตัวสร้าง Text() เพื่อสร้างโหนดข้อความสำหรับย่อหน้า
  3. เรียกใช้เมธอด AppendChild() ของคลาส MarkdownSyntaxNode เพื่อเพิ่มโหนดข้อความและช่องว่างลงในย่อหน้า
  4. ใช้ตัวสร้าง Whitespace() เพื่อสร้างช่องว่างระหว่างโหนดข้อความในย่อหน้า
  5. สร้างและเพิ่มองค์ประกอบ newLineTrivia สำหรับบรรทัดว่างหลังย่อหน้า ใช้ตัวสร้าง NewLineTrivia() และเมธอด Add()
  6. หลังจากรวบรวมโหนดย่อหน้าทั้งหมดเป็นองค์ประกอบเดียวแล้ว ให้เพิ่มไปยังโครงสร้างไวยากรณ์ของเอกสาร

เพิ่ม Markdown Paragraph ใน C#

ตัวอย่างโค้ด C# ต่อไปนี้แสดงวิธีเพิ่มย่อหน้าในเอกสาร MD ที่มีอยู่:

รหัส C# เพื่อเพิ่มย่อหน้า

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

เอกสาร

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


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

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

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

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


ความต้องการของระบบ

API ของเรารองรับบนแพลตฟอร์มและระบบปฏิบัติการหลักทั้งหมด ก่อนดำเนินการโค้ด โปรดตรวจสอบให้แน่ใจว่าคุณมีข้อกำหนดเบื้องต้นต่อไปนี้ในระบบของคุณ

  • Microsoft Windows หรือระบบปฏิบัติการที่เข้ากันได้กับ .NET Framework, .NET Core, Windows Azure, Mono หรือ Xamarin Platforms
  • สภาพแวดล้อมการพัฒนาเช่น Microsoft Visual Studio
  • Aspose.HTML for .NET DLL ที่อ้างอิงในโครงการของคุณ – ติดตั้งจาก NuGet โดยใช้ปุ่มดาวน์โหลดด้านบน