Markdown Converter API dành cho Developers
Chuyển đổi Markdown, PDF, Word và HTML theo lập trình với một REST endpoint duy nhất. Hỗ trợ đầy đủ công thức toán LaTeX và sơ đồ Mermaid, được host sẵn và có thể gọi từ bất kỳ ngôn ngữ nào. Lấy API key trên RapidAPI và bắt đầu chuyển đổi trong vài phút.
Hướng Dẫn Nhanh Markdown Conversion API
Chỉ hai lần gọi: gửi file để nhận task ID, sau đó poll lấy URL tải về. Tất cả endpoint đều theo cùng một pattern.
# 1. Submit a Markdown file for PDF conversion
curl -X POST "https://markdown-converter-pro.p.rapidapi.com/apix/md-to-pdf" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: markdown-converter-pro.p.rapidapi.com" \
-F "source_file=@README.md"
# -> { "task_id": "550e8400-...", "status": "processing" }
# 2. Poll for the result until status is "completed"
curl -X POST "https://markdown-converter-pro.p.rapidapi.com/apix/query-task" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: markdown-converter-pro.p.rapidapi.com" \
-d "task_id=550e8400-..."
# -> { "status": "completed", "to_url": "https://.../README.pdf" }1. Gửi yêu cầu chuyển đổi
Gửi file upload (source_file) hoặc URL file công khai (source_file_url). API trả về task_id.
2. Poll lấy kết quả
Poll query-task với task_id cho đến khi status là completed, rồi tải file từ to_url.
Các Endpoint API Markdown sang PDF, Word & HTML
Tất cả endpoint đều nhận POST với multipart/form-data và trả về task_id. Base path: /apix.
| Method | Endpoint | Mô tả | Công cụ online |
|---|---|---|---|
| POST | /apix/md-to-pdf | Chuyển đổi Markdown sang PDF, có render LaTeX và Mermaid. | Dùng thử online |
| POST | /apix/md-to-docx | Chuyển đổi Markdown thành tài liệu Word (.docx) có thể chỉnh sửa. | Dùng thử online |
| POST | /apix/md-to-html | Chuyển đổi Markdown sang HTML sạch, đúng ngữ nghĩa. | Dùng thử online |
| POST | /apix/pdf-to-md | Trích xuất Markdown từ PDF, bao gồm văn bản, bảng và hình ảnh. | Dùng thử online |
| POST | /apix/docx-to-md | Chuyển đổi tài liệu Word (.docx) sang Markdown. | Dùng thử online |
| POST | /apix/html-to-md | Chuyển đổi trang HTML hoặc fragment sang Markdown sạch. | Dùng thử online |
| POST | /apix/query-task | Poll một task theo task_id và lấy URL tải về khi sẵn sàng. | — |
Cách Async Conversion API Hoạt Động
Các tác vụ chuyển đổi chạy bất đồng bộ, nên file lớn không bao giờ block request của bạn.
Gửi yêu cầu
POST file Markdown, PDF, Word hoặc HTML của bạn — dưới dạng upload hoặc URL công khai — đến endpoint tương ứng.
Nhận task ID
API trả về ngay một task_id với status processing. Không có long-held connection nào bị giữ.
Poll & tải về
Gọi query-task với task_id. Khi status là completed, tải file từ to_url trong response.
Markdown Converter API Hỗ Trợ Render Những Gì
Từ phương trình LaTeX đến sơ đồ Mermaid, API chuyển đổi Markdown phức tạp thành PDF, Word và HTML chuẩn xác mà không mất dữ liệu.
Toán LaTeX
Công thức LaTeX inline và block đều được render chính xác trong output PDF và Word — lý tưởng cho tài liệu học thuật và kỹ thuật.
Sơ Đồ Mermaid
Flowchart, sequence diagram, Gantt chart và class diagram viết bằng Mermaid được render thành đồ họa thực sự.
Hỗ Trợ Đầy Đủ GFM
Pipe table, task list, fenced code block với syntax highlighting, strikethrough và auto-linking — tất cả đều được giữ nguyên.
Hai Chiều
Chuyển đổi từ Markdown sang PDF, Word và HTML — hoặc chuyển đổi ngược các định dạng đó về Markdown sạch phục vụ version control.
Các Use Case của Markdown Conversion API
Developers dùng API để tự động generate tài liệu — trong build pipeline, tính năng sản phẩm và các tác vụ xử lý hàng loạt.
CI/CD Pipeline
Tự động generate release note, báo cáo hoặc PDF artifact từ Markdown trong mỗi build, không cần duy trì headless browser.
Công Cụ Tài Liệu
Chuyển đổi tài liệu Markdown thành PDF hoặc Word có thể tải về cho người dùng, khách hàng và đọc offline — hoàn toàn tự động.
Chuyển Đổi Hàng Loạt
Xử lý số lượng lớn tài liệu phía server bằng cách truyền URL file công khai, sau đó thu thập kết quả theo task ID.
Giá API Markdown Converter
API được tính phí qua RapidAPI với gói miễn phí để bắt đầu và các gói trả phí mở rộng theo mức sử dụng của bạn. Thanh toán, quản lý key và giới hạn rate đều được xử lý trong tài khoản RapidAPI.
Basic
30
requests / tháng
Pro
800
requests / tháng
+ $0.02 / request
Ultra
4,000
requests / tháng
+ $0.012 / request
Mega
12,000
requests / tháng
+ $0.008 / request
Hạn mức và giá được thiết lập trên RapidAPI và có thể thay đổi — kiểm tra các gói hiện hành để biết chi tiết mới nhất.
Xem Các Gói Trên RapidAPIFAQ Tích Hợp Markdown API
Mọi thứ một developer mới cần biết để đăng ký, xác thực, gửi request và chọn gói cho Markdown conversion API.
Làm thế nào để bắt đầu sử dụng Markdown conversion API?
Tạo tài khoản RapidAPI miễn phí, mở Markdown Converter Pro API trên RapidAPI Hub và đăng ký một gói — gói Basic là miễn phí. Sau khi đăng ký, bạn có thể gọi bất kỳ endpoint nào ngay lập tức bằng các đoạn code mẫu ở trên.
Tôi tìm API key ở đâu?
Sau khi đăng ký, RapidAPI cấp một API key cá nhân cho tài khoản của bạn. Bạn có thể tìm thấy nó trong RapidAPI dashboard và trong tab Code Snippets của bất kỳ endpoint nào. Gửi key này trong mỗi request qua header X-RapidAPI-Key, kèm theo header X-RapidAPI-Host được hiển thị cạnh đó.
API hỗ trợ những loại chuyển đổi nào?
API có sáu conversion endpoint — Markdown sang PDF, Word và HTML, cộng với chiều ngược lại từ PDF, Word và HTML về Markdown — và một endpoint query-task để lấy kết quả. Bảng endpoint ở trên liệt kê đường dẫn chính xác cho từng loại.
Một conversion request cần những tham số gì?
Mỗi conversion endpoint nhận request multipart/form-data với một trong hai field: source_file để upload file trực tiếp, hoặc source_file_url để trỏ đến file có thể truy cập công khai. Chỉ dùng một trong hai — nếu gửi cả hai, source_file sẽ được ưu tiên. File có thể lên tới 50 MB và kiểu file phải khớp với endpoint, ví dụ md-to-pdf yêu cầu file .md.
Làm thế nào để lấy file đã chuyển đổi?
Các tác vụ chuyển đổi chạy bất đồng bộ, nên một request thành công trả về task_id thay vì file trực tiếp. Truyền task_id đó vào endpoint query-task và tiếp tục poll cho đến khi status là completed, rồi tải file hoàn chỉnh từ to_url trong response.
Điều gì xảy ra khi quá trình chuyển đổi thất bại?
Nếu không thể hoàn thành chuyển đổi, query-task trả về status failed thay vì completed. Các nguyên nhân thường gặp là kiểu file không khớp với endpoint, source_file_url không thể truy cập công khai, hoặc file lớn hơn 50 MB. Hãy kiểm tra lại đầu vào và gửi lại request.
Tôi nên chọn gói giá nào?
Bắt đầu với gói Basic miễn phí để kiểm tra tích hợp của bạn, sau đó nâng lên gói trả phí khi lượng request hàng tháng tăng lên. Mỗi gói bao gồm hạn mức request hàng tháng và tính phí thêm theo từng request vượt mức — bảng giá ở trên hiển thị các mức hiện tại. Thanh toán và giới hạn được quản lý trong tài khoản RapidAPI của bạn.
File của tôi được xử lý thế nào sau khi chuyển đổi?
File của bạn không được lưu lại. Tài liệu upload và output đã chuyển đổi chỉ được xử lý tạm thời rồi xóa đi, và file hoàn chỉnh được phục vụ qua URL tải về có thời hạn ngắn thay vì lưu trữ lâu dài.
Bắt Đầu Chuyển Đổi Trong Vài Phút
Đăng ký trên RapidAPI, lấy key của bạn và thực hiện lần gọi chuyển đổi đầu tiên ngay hôm nay.
Bắt Đầu Trên RapidAPI