Doc2MD API
API built with Python (FastAPI + MarkItDown) to convert documents (DOCX, PDF, PPTX, images, etc.) into Markdown. Includes API Key authentication and is configured to run in Docker/Coolify, with a built-in healthcheck.
Features
- Convert common document formats to Markdown (
.docx,.pdf,.pptx,.xlsx,.html, images, etc.). - Secure file upload via
multipart/form-data. - API Key protection (via
X-API-Keyheader). /healthendpoint for monitoring.- Ready for Docker and DevContainer environments.
Running Locally
Requirements
Local setup
uvicorn app:api --reload
Access the API at: http://localhost:8000/docs
Running with Docker
Build
Run
Authentication
All requests must include the header:
Set your API key via the API_KEY environment variable.
Endpoints
Healthcheck
Response:
Convert document
Headers:
X-API-Key: supersecret
Body (form-data):
file: document file (.docx,.pdf, etc.)
Example using curl:
-F "file=@mydocument.docx" \
http://localhost:8000/convert
Response:
"filename": "mydocument.md",
"markdown": "# Title\n\nConverted content in Markdown..."
}
DevContainer
The project includes VS Code DevContainer support. Open it in VS Code and select "Reopen in Container" to start with a fully prepared development environment.
License
MIT - you are free to use, modify, and contribute.
Donations
This initiative is open-source and free to use. If you find it valuable and would like to contribute, you can make a donation as a way to support the continuation of this work.
Project powered by FastAPI and MarkItDown.