Để di chuyển tài liệu sang Markdown, cung cấp cho một tác nhân AI thư mục lưu trữ và để nó chạy convert_to_markdown một lần cho mỗi tệp, trong các lô đã được xem xét. Với GroupDocs.Markdown.Mcp, việc này diễn ra cục bộ trong Claude Code, Cursor, GitHub Copilot hoặc một khách hàng MCP khác, vì vậy một kho lưu trữ các quy trình nội bộ không bao giờ được tải lên dịch vụ chuyển đổi:

Chuyển đổi mọi thứ trong thư mục lưu trữ sang Markdown với front matter và hình ảnh dưới dạng tệp. Báo cáo định dạng nguồn, số trang và kích thước đầu ra cho mỗi tệp.

Phiên bản từng bước với cấu hình và khắc phục sự cố có trong tài liệu: Cách di chuyển tài liệu kế thừa sang Markdown với AI.

Tại sao việc di chuyển tài liệu kế thừa lại là công việc cho một tác nhân?

Quá trình chuyển đổi là cơ học và công việc xung quanh lặp đi lặp lại: liệt kê các tệp, chuyển đổi từng tệp, đo kết quả, tìm các lỗi, lặp lại. Một người thực hiện việc này cho hàng trăm tệp sẽ đưa ra cùng một quyết định hàng trăm lần. Một tác nhân thực hiện một cách nhất quán và báo cáo mỗi kết quả, trong khi engine, không phải model, tạo ra Markdown. Markdown được lưu không phải là bản diễn giải lại các quy trình của bạn.

Đây là một runbook. Mỗi bước có một prompt, và bảng phía sau tách biệt những gì tác nhân quyết định và những gì engine thực hiện.

Runbook: làm thế nào để tôi di chuyển một kho Word sang Markdown?

  1. Kiểm tra giấy phép trước mọi thứ.

    Trước khi chuyển đổi bất kỳ thứ gì: trạng thái giấy phép của máy chủ markdown là gì?

    get_license_status trả về mode, licensed, consumption và các phiên bản của server và engine. Chế độ đánh giá chỉ xử lý 3 trang mỗi tài liệu, vì vậy một lần chạy không có giấy phép sẽ tạo ra các bản nháp hợp lý.

  2. Kiểm kê kho lưu trữ.

    Liệt kê mọi tệp trong thư mục lưu trữ cùng với định dạng, số trang và liệu nó có được mã hóa hay không.

    Máy chủ Markdown không có công cụ liệt kê thư mục, vì vậy tác nhân sẽ liệt kê thư mục bằng quyền truy cập tệp của khách hàng hoặc làm việc dựa trên tên tệp bạn cung cấp.

    Sau đó get_document_info trả về fileFormat, pageCount, title, author và isEncrypted cho mỗi tệp mà không chuyển đổi. Các tệp được mã hóa cần tham số password.

  3. Chạy thử khoảng hai mươi tệp.

    Chuyển đổi hai mươi tài liệu đầu tiên sang Markdown với front matter và hình ảnh dưới dạng tệp. Báo cáo định dạng, số trang và kích thước đầu ra cho mỗi tệp.

  4. Tìm những gì không chuyển đổi.

    Liệt kê các PDF mà quá trình chuyển đổi tạo ra dưới 2 KB Markdown cho hơn 5 trang.

    Những tệp này hầu hết là bản quét. Máy chủ này không có bước OCR, vì vậy chúng cần công cụ khác hoặc giữ nguyên dưới dạng PDF được lập chỉ mục bằng metadata.

  5. Sửa mẫu, sau đó chạy phần còn lại theo lô. Hai mươi tệp mỗi vòng, kèm báo cáo mỗi lần, giúp quá trình chạy có thể xem xét và việc sử dụng có đo lường được dự đoán.

  6. Xem lại đầu ra như khi bạn xem một pull request. Các phần tiếp theo liệt kê những gì cần kiểm tra.

Quyết định Tác nhân Engine
Tệp nào cần chuyển đổi, theo thứ tự và kích thước lô nào Yes No
Các tùy chọn nào cần truyền (images, frontMatter, flavor) Yes, from your prompt No
Chuyển tiêu đề, danh sách và bảng sang Markdown No Yes
Lưu các tệp .md và hình ảnh No Yes
Phát hiện tệp 300 trang đã giảm còn 4 KB Yes, from the report No
Đổi tên, bố cục thư mục, các khóa front-matter bổ sung Yes No

Định dạng nào di chuyển tốt?

  • DOCX, DOC, RTF, ODT. Cấu trúc rõ ràng trong nguồn, vì vậy tiêu đề và bảng được chuyển đổi sạch sẽ.
  • EPUB và MOBI. Cấu trúc chương được ánh xạ thành tiêu đề Markdown.
  • CHM. Các tệp trợ giúp cũ, thường là bản sao duy nhất của một quy trình.
  • XLSX. Các bảng tính trở thành bảng, phù hợp với danh sách tham số.

Kiểm tra gì trong bước xem xét?

Yêu cầu tác nhân thực hiện lần quét đầu tiên, sau đó tự bạn đọc một mẫu:

Đối với mỗi tệp đã chuyển đổi, liệt kê các hình ảnh mà nó tham chiếu và cho tôi biết tệp hình ảnh nào bị thiếu.

Hiển thị cho tôi năm đầu ra có kích thước nhỏ nhất so với số trang của chúng.

Hình ảnh được ghi bằng images: "file" nằm cạnh tệp .md và được tham chiếu bằng đường dẫn tương đối, đó là điều mà kho tài liệu mong đợi. Một tệp .md trỏ tới các hình ảnh chưa được ghi sẽ hiển thị dưới dạng hình ảnh bị hỏng. Sau đó mở nguồn phức tạp nhất và đầu ra của nó cạnh nhau trước khi bạn áp dụng mẫu cho phần còn lại. Cam kết kết quả đã xem xét bằng quy trình git thông thường của bạn; máy chủ ghi các tệp và không chạm vào kho lưu trữ của bạn.

Phiên làm việc mẫu (rút gọn)

Bạn:   Chuyển đổi hai mươi tài liệu đầu tiên trong /archive sang Markdown với front matter
       và hình ảnh dưới dạng tệp. Báo cáo định dạng, số trang và kích thước đầu ra cho mỗi tệp.
Tác nhân: convert_to_markdown (frontMatter: true, images: "file") x 20
       ops-manual-2014.docx   DOCX   88 pages   converted
       install-guide.chm      CHM    41 pages   converted
       supplier-forms-2009.pdf PDF   12 pages   1 KB of Markdown: probably a scan
       Mười chín tệp trông nhất quán; một bản quét cần xử lý riêng.

Giới hạn thực tế

Không có giấy phép, chế độ đánh giá chỉ xử lý 3 trang đầu tiên của mỗi tài liệu, kèm watermark đánh giá trên mỗi tệp. Một lần chạy di chuyển trong trạng thái này tạo ra hàng trăm tệp ngắn trông đúng, và khoảng trống sẽ được phát hiện sau vài tuần khi ai đó tìm kiếm một quy trình bị thiếu. Di chuyển cần giấy phép, vì vậy hãy chạy get_license_status trước lô đầu tiên. Các PDF đã quét không chuyển đổi.

Câu hỏi thường gặp

Tôi có thể chuyển đổi hàng trăm tài liệu Word sang Markdown cùng một lúc không?

Có, nhưng không trong một prompt duy nhất. Chuyển đổi theo lô khoảng hai mươi tệp và đọc báo cáo sau mỗi lần, để tùy chọn sai được sửa trước khi áp dụng cho toàn bộ kho lưu trữ.

Làm thế nào để tôi di chuyển tài liệu vào git với một tác nhân AI?

Máy chủ ghi các tệp .md và tệp hình ảnh vào thư mục đầu ra. Bạn xem xét chúng và cam kết chúng bằng quy trình git thông thường của mình.

Quá trình di chuyển docs-as-code có tải lên tài liệu của tôi không?

Không. GroupDocs.Markdown.Mcp là một quá trình cục bộ, và kho lưu trữ được đọc từ đĩa. Chỉ những gì tác nhân ghi trong cuộc trò chuyện mới tới nhà cung cấp mô hình.

Tìm hiểu sâu hơn