Conversion Service
MarkFoundry is hosted on Vercel. Heavy conversions are handled by a separate Docker service running Pandoc.
Architecture
Why conversion is separated
PDF and DOCX conversion requires heavy processing that is unreliable within serverless function time limits. A dedicated conversion service provides better reliability and output quality.
Why Pandoc
Pandoc is a universal document converter supporting dozens of formats. It produces high-quality DOCX and PDF output from Markdown source.
Why Docker
Docker packages Pandoc and its dependencies in a consistent environment, making deployment predictable across platforms.
How Vercel connects
The MarkFoundry Vercel app sends conversion requests to API routes, which forward content to the Docker conversion service and return generated files to the browser.
Supported conversions
- Markdown → PDF
- Markdown → DOCX
- Markdown → HTML
- DOCX → Markdown (import)
Security notes
Conversion requests should use secure HTTPS connections. Files are processed temporarily and should not be stored permanently by default.
Deployment options
The conversion service can be deployed on:
- Render
- Railway
- Fly.io
- DigitalOcean
- AWS
- VPS