เพื่อย้ายเอกสารไปเป็น Markdown ให้เอาโฟลเดอร์เก็บไฟล์ให้กับเอเจนต์ AI แล้วให้มันเรียก convert_to_markdown หนึ่งครั้งต่อไฟล์ในชุดที่ตรวจสอบแล้ว ด้วย GroupDocs.Markdown.Mcp สิ่งนี้เกิดขึ้นในเครื่องโดยใช้ Claude Code, Cursor, GitHub Copilot หรือไคลเอนต์ MCP อื่น ๆ ดังนั้นไฟล์เก็บขั้นตอนภายในจะไม่ถูกอัปโหลดไปยังบริการแปลงใด ๆ:

แปลงทุกอย่างในโฟลเดอร์เก็บไฟล์เป็น Markdown พร้อมกับ front matter และรูปภาพเป็นไฟล์ รายงานรูปแบบต้นฉบับ จำนวนหน้า และขนาดผลลัพธ์สำหรับแต่ละไฟล์

เวอร์ชันขั้นตอนต่อขั้นตอนพร้อมการตั้งค่าและการแก้ไขปัญหาอยู่ในเอกสาร: วิธีย้ายเอกสารเก่าเป็น Markdown ด้วย AI

ทำไมการย้ายเอกสารเก่าถึงเป็นงานสำหรับเอเจนต์?

การแปลงเป็นกระบวนการเชิงกลและงานรอบข้างเป็นการทำซ้ำ: รายการไฟล์, แปลงแต่ละไฟล์, วัดผลลัพธ์, ค้นหาความล้มเหลว, ทำซ้ำ คนที่ทำเช่นนี้กับไฟล์หลายร้อยไฟล์จะต้องตัดสินใจเดียวกันหลายร้อยครั้ง เอเจนต์ทำอย่างสม่ำเสมอและรายงานผลแต่ละอย่าง ในขณะที่เอนจิน—not the model—สร้าง Markdown ไฟล์ Markdown ที่บันทึกไว้ไม่ใช่การพรรณนาซ้ำของขั้นตอนของคุณ

นี่คือ runbook แต่ละขั้นตอนมีพรอมต์หนึ่งรายการ และตารางต่อจากนั้นแยกสิ่งที่เอเจนต์ตัดสินใจจากสิ่งที่เอนจินทำ

Runbook: ฉันจะย้ายไฟล์ Word archive ไปเป็น Markdown อย่างไร?

  1. ตรวจสอบใบอนุญาตก่อนทำอย่างอื่นใด ๆ.

    ก่อนทำการแปลงอะไรเลย: สถานะใบอนุญาตของเซิร์ฟเวอร์ markdown คืออะไร?

    get_license_status คืนค่า mode, licensed, consumption และเวอร์ชันของเซิร์ฟเวอร์และเอนจิน โหมดประเมินผลจะประมวลผล 3 หน้าต่อเอกสาร ดังนั้นการรันโดยไม่มีใบอนุญาตจะสร้างสตับที่ดูสมเหตุสมผล

  2. ทำรายการไฟล์ใน archive.

    รายการไฟล์ทุกไฟล์ในโฟลเดอร์ archive พร้อมรูปแบบ จำนวนหน้า และว่ามีการเข้ารหัสหรือไม่

    เซิร์ฟเวอร์ Markdown ไม่มีเครื่องมือแสดงรายการโฟลเดอร์ ดังนั้นเอเจนต์จะทำรายการโฟลเดอร์โดยใช้การเข้าถึงไฟล์ของไคลเอนต์ของมันเองหรือทำงานจากชื่อไฟล์ที่คุณให้

    จากนั้น get_document_info จะคืนค่า fileFormat, pageCount, title, author และ isEncrypted สำหรับแต่ละไฟล์โดยไม่ต้องแปลงไฟล์ ไฟล์ที่เข้ารหัสต้องใช้พารามิเตอร์ password

  3. รันพายล็อตประมาณยี่สิบไฟล์.

    แปลงเอกสารยี่สิบฉบับแรกเป็น Markdown พร้อม front matter และรูปภาพเป็นไฟล์ รายงานรูปแบบ จำนวนหน้า และขนาดผลลัพธ์สำหรับแต่ละไฟล์

  4. ค้นหาไฟล์ที่ไม่แปลงได้.

    รายการ PDF ที่การแปลงได้ผลลัพธ์ Markdown น้อยกว่า 2 KB สำหรับมากกว่า 5 หน้า

    สิ่งเหล่านี้มักจะเป็นสแกน ไม่มีขั้นตอน OCR ในเซิร์ฟเวอร์นี้ ดังนั้นจึงต้องใช้เครื่องมืออื่นหรือคงไว้เป็น PDF ที่จัดทำดัชนีด้วยเมตาดาต้า

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

  6. ตรวจสอบผลลัพธ์เหมือนกับการตรวจสอบ pull request ส่วนต่อไปนี้จะระบุสิ่งที่ควรตรวจสอบ

การตัดสินใจ เอเจนต์ เอนจิน
ไฟล์ใดบ้างที่จะแปลง, ลำดับและขนาดชุดเป็นอย่างไร ใช่ ไม่
ตัวเลือกใดบ้างที่จะส่ง (images, frontMatter, flavor) ใช่, จากพรอมต์ของคุณ ไม่
การแปลงหัวข้อ, รายการและตารางเป็น Markdown ไม่ ใช่
การบันทึกไฟล์ .md และไฟล์รูปภาพ ไม่ ใช่
การตรวจพบไฟล์ 300 หน้า ที่เหลือเพียง 4 KB ใช่, จากรายงาน ไม่
การเปลี่ยนชื่อ, โครงสร้างโฟลเดอร์, คีย์ front-matter เพิ่มเติม ใช่ ไม่

ฟอร์แมตใดที่ย้ายได้ดี?

  • DOCX, DOC, RTF, ODT. โครงสร้างชัดเจนในต้นฉบับ ดังนั้นหัวข้อและตารางจะถูกแปลงอย่างสะอาด
  • EPUB and MOBI. โครงสร้างบทแสดงเป็นหัวข้อ Markdown
  • CHM. ไฟล์ช่วยเหลือเก่า มักเป็นสำเนาเดียวของขั้นตอน
  • XLSX. แผ่นงานกลายเป็นตาราง ซึ่งเหมาะกับรายการพารามิเตอร์

การตรวจสอบขั้นตอนรีวิวควรตรวจสอบอะไรบ้าง?

ขอให้เอเจนต์ทำการสแกนครั้งแรก แล้วคุณอ่านตัวอย่างด้วยตนเอง:

สำหรับไฟล์ที่แปลงแล้วแต่ละไฟล์ ให้รายการรูปภาพที่อ้างอิงและบอกว่ารูปภาพไฟล์ใดหายไป

แสดงผลลัพธ์ห้าผลลัพธ์ที่มีขนาดเล็กที่สุดเมื่อเทียบกับจำนวนหน้าของมัน

รูปภาพที่เขียนด้วย images: "file" จะอยู่ข้างไฟล์ .md และอ้างอิงด้วยเส้นทางสัมพันธ์ ซึ่งเป็นสิ่งที่ที่เก็บเอกสารคาดหวัง .md ที่ชี้ไปยังรูปภาพที่ไม่เคยถูกเขียนจะทำให้แสดงเป็นรูปภาพเสีย เปิดไฟล์ต้นฉบับที่ยุ่งที่สุดและผลลัพธ์ของมันข้างกันก่อนที่คุณจะนำรูปแบบไปใช้กับส่วนที่เหลือ คอมมิตผลลัพธ์ที่ตรวจสอบแล้วด้วยกระบวนการ git ปกติของคุณ; เซิร์ฟเวอร์จะเขียนไฟล์และไม่แตะต้องที่เก็บของคุณ

ตัวอย่างเซสชัน (สรุป)

คุณ:   แปลงเอกสารยี่สิบฉบับแรกใน /archive เป็น Markdown พร้อม front matter
       และรูปภาพเป็นไฟล์ รายงานรูปแบบ จำนวนหน้า และขนาดผลลัพธ์สำหรับแต่ละไฟล์
เอเจนต์: convert_to_markdown (frontMatter: true, images: "file") x 20
       ops-manual-2014.docx   DOCX   88 หน้า   แปลงแล้ว
       install-guide.chm      CHM    41 หน้า   แปลงแล้ว
       supplier-forms-2009.pdf PDF   12 หน้า   1 KB ของ Markdown: น่าจะเป็นการสแกน
       ไฟล์สิบเก้าภาพดูสอดคล้อง; การสแกนหนึ่งไฟล์ต้องการการจัดการแยก

ข้อจำกัดที่ตรงไปตรงมา

โดยไม่มีใบอนุญาต โหมดประเมินผลจะประมวลผลเฉพาะ 3 หน้าแรกของแต่ละเอกสาร พร้อมลายน้ำการประเมินบนแต่ละไฟล์ การรันการย้ายในสภาวะนั้นจะให้ไฟล์สั้นหลายร้อยไฟล์ที่ดูเหมือนถูกต้อง และช่องว่างจะถูกพบหลายสัปดาห์ต่อมาหากมีคนค้นหาขั้นตอนที่หายไป การย้ายต้องมีใบอนุญาต ดังนั้นให้เรียก get_license_status ก่อนชุดแรก ไฟล์ PDF ที่สแกนจะไม่แปลง

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

ฉันสามารถแปลงเอกสาร Word หลายร้อยไฟล์เป็น Markdown พร้อมกันได้หรือไม่?

ได้, แต่ไม่ในพรอมต์เดียว แปลงเป็นชุดประมาณยี่สิบไฟล์และอ่านรายงานหลังแต่ละชุด เพื่อให้ตัวเลือกที่ผิดถูกแก้ไขก่อนนำไปใช้กับ archive ทั้งหมด

ฉันจะย้ายเอกสารเข้าสู่ git ด้วยเอเจนต์ AI อย่างไร?

เซิร์ฟเวอร์จะเขียนไฟล์ .md และไฟล์รูปภาพลงในโฟลเดอร์ผลลัพธ์ คุณตรวจสอบและคอมมิตด้วยกระบวนการ git ปกติของคุณ

การย้าย docs-as-code จะอัปโหลดเอกสารของฉันหรือไม่?

ไม่ GroupDocs.Markdown.Mcp เป็นกระบวนการในเครื่อง และ archive จะถูกอ่านจากดิสก์ มีเพียงสิ่งที่เอเจนต์เขียนในบทสนทนาที่ส่งถึงผู้ให้บริการโมเดล

ไปลึกกว่า