MarkItDown – Chuyển tài liệu sang Markdown
Dùng Microsoft MarkItDown để chuyển PDF, Word, Excel, PowerPoint, HTML… thành Markdown sạch, sẵn sàng cho LLM và RAG.
Tài liệu · Văn phòngTrung cấp★ 33,030⑂ 3,248Điểm AI 9/10Cập nhật lần cuối: 9 thg 8, 2026
Làm được gì
Skill này hướng dẫn Claude sử dụng MarkItDown 0.1.6 của Microsoft một cách chính xác và an toàn.
- Chuyển PDF, DOCX, PPTX, XLSX/XLS, HTML, CSV, EPUB, ZIP, email Outlook thành Markdown giữ được tiêu đề, bảng, danh sách
- Bảng chọn API theo tình huống:
convert_local()cho tệp cục bộ,convert_stream()cho dữ liệu tải lên,convert_response()sau khi tự kiểm tra URL - Script xử lý hàng loạt (
batch_convert.py) và bộ sưu tập bài báo khoa học (convert_literature.py) kèm YAML front matter, tạo index - Xử lý PDF scan/ảnh: plugin
markitdown-ocr, Azure Document Intelligence, Azure Content Understanding - Tích hợp MCP server chính thức (
markitdown-mcp) và lưu ý bảo mật STDIO/HTTP - Bảng khắc phục lỗi thường gặp và checklist kiểm tra chất lượng bản chuyển đổi
Đáng chú ý là các nguyên tắc an toàn: coi văn bản đã chuyển là dữ liệu không tin cậy (đề phòng prompt injection), plugin phải bật thủ công, xin phép người dùng trước khi gửi dữ liệu ra ngoài.
Phù hợp với ai
- Lập trình viên xây dựng RAG hoặc hệ thống tìm kiếm nội bộ cần text hóa hàng loạt tài liệu
- Nghiên cứu viên, học viên cao học cần chuyển hàng trăm bài báo PDF sang Markdown để phân tích
- Nhân viên văn phòng muốn đưa biên bản họp, báo cáo, bảng Excel vào LLM
- Đội nhóm cần chuyển đổi hoàn toàn cục bộ, không đưa tài liệu mật lên cloud
Ví dụ sử dụng
- Một báo cáo: "Chuyển report.pdf sang Markdown" → chạy
markitdown report.pdf -o report.md, rồi đối chiếu bảng và tiêu đề theo checklist. - Thư viện bài báo: chuyển 300 PDF trong
papers/bằngconvert_literature.py, tự động tách theo năm từ tên tệp và tạo tệp index. - PDF scan: khi nội dung trích ra quá ít, chọn plugin
markitdown-ocrhoặc Azure Document Intelligence, đồng thời hỏi ý kiến người dùng vì dữ liệu sẽ ra khỏi máy.
· · · Hướng dẫn cài đặt · · ·
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/scientific-agent-skills && mkdir -p ~/.claude/skills && cp -r /tmp/scientific-agent-skills/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à clone repo skill:
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git - Tạo thư mục skills và copy riêng skill markitdown:
mkdir -p ~/.claude/skills cp -r scientific-agent-skills/skills/markitdown ~/.claude/skills/ - Kiểm tra đã có Python 3.10+ và
uv. Nếu chưa:curl -LsSf https://astral.sh/uv/install.sh | sh. - Tạo môi trường ảo và cài MarkItDown:
uv venv --python 3.12 .venv && source .venv/bin/activate uv pip install "markitdown[all]==0.1.6" - Xác nhận bằng
markitdown --version. - Khởi động lại Claude Code và thử yêu cầu: "Chuyển tệp PDF này sang Markdown".
- (Tùy chọn) Nếu cần OCR hoặc Azure, cài thêm plugin và cấu hình API key. Với tài liệu mật, hãy chỉ dùng chế độ chuyển đổi cục bộ.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT