Chuyển Word sang Markdown / HTML API
Chuyển file Word .docx sang Markdown, HTML sạch hoặc văn bản thuần, giữ tiêu đề, chữ đậm / nghiêng, liên kết, danh sách đánh số lồng nhau và bảng.
API chuyển DOCX đọc tài liệu Word và viết lại nội dung thành Markdown (mặc định), HTML sạch (format=html, không có style nội tuyến) hoặc văn bản thuần. Tiêu đề lấy theo style của Word (Title, Heading 1–6), đoạn chữ đậm và nghiêng thành đậm / _nghiêng_, liên kết giữ nguyên URL, danh sách gạch đầu dòng và đánh số giữ đúng cấp lồng và số thứ tự, bảng thành bảng Markdown hoặc HTML.
Ngoài content, kết quả có danh sách headings (dàn ý của tài liệu), tiêu đề và tác giả lấy từ thuộc tính tài liệu, cùng stats (số đoạn, mục danh sách, bảng, số từ, số ký tự), tiện để kiểm tra file người dùng tải lên hoặc đưa nội dung vào công cụ tìm kiếm.
Hình ảnh, chú thích (comment), header / footer và phần sửa đổi được theo dõi (track changes) không được chuyển. Chưa hỗ trợ file .doc cũ: hãy lưu lại thành .docx. File được xử lý trong bộ nhớ theo giới hạn dung lượng của gói và không được lưu lại.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
file | body | file | có | File .docx (multipart, body thô hoặc file_base64). | |
format | query|body | string | không | markdown | markdown, html hoặc text. |
Ví dụ
curl -X POST "https://apibox.io.vn/v1/docx-convert" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "0=@./my-file"const form = new FormData();
form.append('0', fileInput.files[0]);
const res = await fetch('https://apibox.io.vn/v1/docx-convert', {
method: 'POST',
headers: { Authorization: 'Bearer YOUR_API_KEY' },
body: form,
});
console.log(await res.json());import requests
res = requests.post(
"https://apibox.io.vn/v1/docx-convert",
headers={"Authorization": "Bearer YOUR_API_KEY"},
files={"0": open("my-file", "rb")},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/docx-convert');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
CURLOPT_POSTFIELDS => ['0' => new CURLFile('my-file')],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Kết quả trả về
{
"format": "markdown",
"title": "HĐ mẫu",
"author": "APIBox",
"modified": null,
"content": "# Hợp đồng dịch vụ\n\n# Điều 1. Phạm vi\n\nBên A **cung cấp** dịch vụ _API_ cho Bên B.\n\n[Xem tài liệu](https://apibox.io.vn/docs/)\n\n1. Bước một\n2. Bước hai\n 1. Chi tiết a\n\n- Điểm chấm\n\n| Gói | Giá |\n| --- | --- |\n| Pro | 15 USD |\n\nHết.",
"headings": [
{
"level": 1,
"text": "Hợp đồng dịch vụ"
},
{
"level": 1,
"text": "Điều 1. Phạm vi"
}
],
"stats": {
"paragraphs": 3,
"list_items": 4,
"tables": 1,
"words": 40,
"characters": 160
},
"note": "Images, comments, headers / footers and tracked changes are not converted."
}
Ứng dụng
- Đăng bài viết soạn bằng Word lên website, CMS dạng Markdown
- Đánh chỉ mục nội dung hợp đồng, báo cáo được tải lên
- Đưa tài liệu Word vào quy trình AI dưới dạng văn bản sạch
- Chuyển tài liệu nội bộ sang wiki hoặc Git
Hỏi đáp
Hình ảnh có được giữ lại không?
Không, chỉ chuyển chữ, danh sách, liên kết và bảng. Hình ảnh, khung văn bản và comment bị bỏ qua.
Có đọc được file .doc, .odt không?
Không, chỉ đọc .docx (Word 2007 trở lên). Hãy lưu các định dạng khác thành .docx trước.
Tiêu đề được nhận ra thế nào?
Theo style của đoạn: Title và Heading 1 thành #, Heading 2 thành ##… Chữ in đậm trong đoạn thường không được coi là tiêu đề.
API liên quan
Metadata ảnh & EXIF
Đọc kích thước, định dạng, thông tin EXIF máy ảnh, thông số chụp và vị trí GPS của ảnh JPEG, PNG, WebP, HEIC, AVIF, GIF… – upload file hoặc qua URL.
PDFMetadata PDF
Đọc metadata file PDF: số trang, tiêu đề, tác giả, phần mềm tạo, ngày tạo, phiên bản PDF, mã hoá, số trường form và khổ giấy từng trang (A4, Letter…).
PDF₫Tạo PDF báo giá, phiếu thu
Tạo PDF báo giá, phiếu thu, đơn đặt hàng, hoá đơn bán hàng gọn đẹp từ JSON: tiếng Việt chuẩn, thuế GTGT, số tiền bằng chữ và mã VietQR để thanh toán.