การรวม Markdown ใน C# ทำงานอย่างไร
Aspose.HTML for .NET
รวม Markdown ด้วยเวิร์กโฟลว์ C# สองขั้นตอน Converter.ConvertMarkdown() จะแยกวิเคราะห์ต้นฉบับ .md แต่ละรายการเป็น HTMLDocument จากนั้น HtmlRenderer จะเขียนเอกสารที่แปลงแล้วไปยังอุปกรณ์เอาต์พุตเดียวตามลำดับที่ระบุ ผลลัพธ์คือเอกสาร PDF, XPS, DOCX หรือ TIFF ไม่ใช่ไฟล์ Markdown ที่แก้ไขได้ซึ่งเกิดจากการต่อข้อความเข้าด้วยกัน
รวม Markdown ใน C# พร้อมตัวอย่างแบบโต้ตอบ
ใช้ตัวอย่างแบบโต้ตอบเพื่อกำหนดลำดับต้นฉบับและสร้างเวิร์กโฟลว์ C# ที่ตรงกัน เพิ่มไฟล์ Markdown ตามลำดับที่ต้องการ แล้วเลือก PDF, XPS, DOCX หรือ TIFF แผงโค้ดจะอัปเดตชื่อไฟล์ อุปกรณ์เรนเดอร์ และนามสกุลเอาต์พุตทุกครั้งที่มีการเปลี่ยนตัวเลือก คุณยังสามารถเรียกใช้การรวมที่กำหนดค่าไว้ทางออนไลน์เพื่อตรวจสอบผลลัพธ์ได้
using Aspose.Html;
using Aspose.Html.Converters;
using Aspose.Html.Rendering;
using Aspose.Html.Rendering.Pdf;
// Convert the Markdown files to HTML documents in the required merge order.
using HTMLDocument document1 = Converter.ConvertMarkdown("first.md");
using HTMLDocument document2 = Converter.ConvertMarkdown("second.md");
// Create the renderer and the PDF output device.
using HtmlRenderer renderer = new HtmlRenderer();
using PdfDevice device = new PdfDevice("merged.pdf");
// Render the documents into one PDF file.
renderer.Render(device, document1, document2);
เวิร์กโฟลว์สำหรับรวมไฟล์ Markdown
ตัวอย่างใช้ PDF เป็นค่าเริ่มต้น เวิร์กโฟลว์สองขั้นตอนเดียวกันนี้ใช้กับเอาต์พุตที่อาศัยอุปกรณ์ชนิดอื่นซึ่งมีอยู่ในวิดเจ็ตได้
- เรียก
Converter.ConvertMarkdown()สำหรับไฟล์ต้นฉบับแต่ละไฟล์เพื่อสร้างHTMLDocument - จัดเอกสารผลลัพธ์ตามลำดับที่ต้องการให้หน้าที่เรนเดอร์แล้วปรากฏ
- สร้างอินสแตนซ์
HtmlRenderer - สร้างอุปกรณ์เอาต์พุต เช่น
PdfDeviceสำหรับ PDF - ส่งอุปกรณ์และเอกสารที่แปลงแล้วทั้งหมดไปยัง
HtmlRenderer.Render()
เลือกรูปแบบเอาต์พุตสำหรับการรวม Markdown
- PDF – สร้างเอกสารเค้าโครงคงที่สำหรับการเผยแพร่หรือการพิมพ์
- XPS – เขียนหน้าที่เรนเดอร์แล้วลงในเอกสาร XPS
- DOCX – สร้างเอกสารที่เปิดได้ใน Microsoft Word หรือโปรแกรมแก้ไขอื่นที่รองรับ
- TIFF – เรนเดอร์หน้าที่รวมแล้วเป็นเอาต์พุตภาพแรสเตอร์
โค้ด C# ที่สร้างขึ้นจะเลือก PdfDevice, XpsDevice, DocDevice หรือ ImageDevice ตามรูปแบบที่เลือก ดูการตั้งค่าเฉพาะรูปแบบได้ใน
อุปกรณ์เรนเดอร์ใน C#
ข้อควรรู้เมื่อรวมไฟล์ Markdown
- ผลลัพธ์คือเอาต์พุตที่เรนเดอร์แล้ว หัวเรื่อง รายการ บล็อกโค้ด ลิงก์ และเนื้อหา Markdown อื่นที่แยกวิเคราะห์แล้วจะเป็นส่วนหนึ่งของเอกสาร HTML ขั้นกลาง โดยไม่มีการต่อไฟล์ต้นฉบับ
.mdเข้าด้วยกัน - ลำดับอินพุตกำหนดลำดับเอาต์พุต จัดเรียงไฟล์ในวิดเจ็ต หรือส่งออบเจ็กต์
HTMLDocumentที่แปลงแล้วไปยังRender()ตามลำดับที่ต้องการ - ทรัพยากรที่อ้างอิงต้องพร้อมใช้งาน ภาพสัมพัทธ์และทรัพยากรที่เชื่อมโยงอื่นต้องมีตำแหน่งที่แก้ไขได้ขณะเรนเดอร์ HTML ขั้นกลาง
- การตั้งค่าเอาต์พุตขึ้นอยู่กับอุปกรณ์ ขนาดหน้า ระยะขอบ ความละเอียด และตัวเลือกอื่นเป็นของอุปกรณ์เอาต์พุตและตัวเลือกการเรนเดอร์ที่เลือก ไม่ใช่ตัวแยกวิเคราะห์ Markdown
ติดตั้ง Aspose.HTML for .NET
ติดตั้ง Aspose.HTML for .NET จาก NuGet ด้วย .NET CLI:
dotnet add package Aspose.HTML
คุณยังสามารถใช้หน้าต่าง NuGet Package Manager หรือเรียกใช้ Install-Package Aspose.HTML ใน Package Manager Console ได้ ดูรายละเอียดการตั้งค่าใน
คู่มือการติดตั้ง
หรือขอ
ใบอนุญาตชั่วคราว
เพื่อประเมิน API โดยไม่มีข้อจำกัดของเวอร์ชันทดลอง
คำถามที่พบบ่อยเกี่ยวกับการรวมไฟล์ Markdown
1. ฉันสามารถรวม Markdown ที่ส่งมาเป็นสตรีมได้หรือไม่?
ได้ ใช้โอเวอร์โหลด Converter.ConvertMarkdown(Stream, string) สำหรับต้นฉบับแต่ละรายการ และระบุ URI ฐานที่ช่วยแก้ไขลิงก์และภาพสัมพัทธ์ เมธอดจะส่งคืน HTMLDocument ซึ่งสามารถรวมในการเรียกตัวเรนเดอร์พร้อมกับต้นฉบับอื่นที่แปลงแล้วได้
2. ฉันสามารถแก้ไข Markdown ที่แปลงแล้วก่อนเรนเดอร์ผลลัพธ์ได้หรือไม่?
ได้ Converter.ConvertMarkdown() ส่งคืน HTMLDocument แอปพลิเคชันจึงตรวจสอบหรือแก้ไข DOM ก่อนส่งไปยัง HtmlRenderer.Render() ได้ วิธีนี้มีประโยชน์เมื่อเอาต์พุตที่รวมแล้วต้องมีหัวเรื่องที่สร้างขึ้น ตัวคั่น หรือเนื้อหาที่ปรับให้เป็นมาตรฐาน
3. Markdown ที่แปลงแล้วและเอกสาร HTML ที่มีอยู่ใช้เอาต์พุตเดียวกันได้หรือไม่?
ได้ หลังจากต้นฉบับ Markdown กลายเป็นออบเจ็กต์ HTMLDocument แล้ว ให้นำไปรวมกับ HTMLDocument ที่มีอยู่ในการเรียก HtmlRenderer.Render() ครั้งเดียวกัน ลำดับอาร์กิวเมนต์จะกำหนดลำดับเอกสารในเอาต์พุตที่เรนเดอร์แล้ว
4. ภาพสัมพัทธ์จากไฟล์ Markdown จะปรากฏในผลลัพธ์หรือไม่?
ภาพจะปรากฏเมื่อแก้ไขพาธได้และเข้าถึงทรัพยากรได้ระหว่างการเรนเดอร์ เก็บตำแหน่งต้นฉบับและทรัพยากรที่เกี่ยวข้องไว้ด้วยกัน หรือระบุตำแหน่งฐานของเอกสารที่ชี้ไปยังไฟล์ภาพที่ถูกต้อง
5. ฉันสามารถกำหนดขนาดหน้าและระยะขอบของ PDF ที่รวมแล้วได้หรือไม่?
ได้ สร้าง PdfRenderingOptions กำหนดค่า PageSetup แล้วส่งตัวเลือกไปยัง PdfDevice การตั้งค่าหน้าที่เลือกจะมีผลเมื่อเอกสาร Markdown ที่แปลงแล้วทั้งหมดถูกเรนเดอร์ไปยัง PDF เดียวกัน
เครื่องมือรวมไฟล์ที่เกี่ยวข้อง
เลือกรูปแบบต้นฉบับอื่นหรือกลับไปยังภาพรวมเครื่องมือรวมไฟล์