Chuyển đổi tài liệu sang Markdown với MarkItDown
Skill hướng dẫn dùng Microsoft MarkItDown để chuyển PDF, Office, HTML, CSV… thành Markdown sạch cho phân tích văn bản và RAG.
Tài liệu · Văn phòngTrung cấp★ 33,030⑂ 3,248Điểm AI 10/10Cập nhật lần cuối: 9 thg 8, 2026
Làm được gì
- Chuyển PDF, Word, PowerPoint, Excel, HTML, CSV, EPUB, ZIP thành Markdown giữ được cấu trúc, theo MarkItDown 0.1.6.
- Bảng quyết định rõ ràng nên dùng API nào:
convert_local,convert_stream,convert_responsehayconvert_uri. - Script chuyển đổi hàng loạt cả thư mục và chuyển đổi bộ tài liệu học thuật (thêm YAML front matter, sắp theo năm, tạo index).
- Hướng dẫn OCR cho PDF scan (plugin
markitdown-ocr, Azure Document Intelligence / Content Understanding), chạy MCP server và bảng xử lý sự cố. - Quy tắc an toàn: coi văn bản đã chuyển là dữ liệu không đáng tin (chống prompt injection) và phải xin phép trước khi gửi nội dung ra dịch vụ ngoài.
Phù hợp với ai
- Lập trình viên, data engineer xây pipeline RAG hoặc chỉ mục tìm kiếm nội bộ.
- Nghiên cứu viên, học viên cao học cần bóc tách hàng trăm PDF bài báo thành text.
- Người làm văn phòng muốn chuẩn hóa tài liệu công ty sang định dạng LLM đọc được.
Ví dụ sử dụng
markitdown report.pdf -o report.mdđể chuyển nhanh một báo cáo.python scripts/batch_convert.py documents/ markdown/ --recursive --extensions .pdf .docx --manifest markdown/manifest.jsonđể xử lý cả thư mục kèm manifest.python scripts/convert_literature.py papers/ literature-markdown/ --recursive --create-indexđể sắp xếp bài báo dạngSmith_2025_Title.pdftheo năm và tạo mục lục.- Với hợp đồng scan gần như không có text, chuyển sang plugin
markitdown-ocrhoặc Azure OCR (cần đồng ý trước vì dữ liệu ra khỏi máy).
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/K-Dense-AI/scientific-agent-skills/HEAD/skills/markitdown/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục skills/markitdown từ repo GitHub K-Dense-AI/scientific-agent-skills vào ~/.claude/skills/markitdown/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/sas && mkdir -p ~/.claude/skills && cp -r /tmp/sas/skills/markitdown ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal và tải repo:
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git - Sao chép skill vào thư mục skill của Claude Code:
mkdir -p ~/.claude/skills && cp -r scientific-agent-skills/skills/markitdown ~/.claude/skills/ - Kiểm tra bạn có Python 3.10+ và
uv(uv --version). - Tạo và bật môi trường ảo:
uv venv --python 3.12 .venv && source .venv/bin/activate - Cài MarkItDown:
uv pip install "markitdown[all]==0.1.6"(hoặc chỉ các extra cần thiết:markitdown[pdf,docx,pptx,xlsx]==0.1.6). - Xác minh bằng
markitdown --version. - Khởi động lại Claude Code, rồi yêu cầu ví dụ: "chuyển file PDF này sang Markdown".
- (Tùy chọn) Nếu cần OCR/Azure/MCP, đọc
references/cloud_and_ocr.mdvàreferences/mcp_and_plugins.mdđể cấu hình khóa và chính sách gửi dữ liệu.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT