akash26052005/aksha-doc-server repository overview

⁠🚀 AkshaDoc Server

Transform Markdown into Beautiful Handbooks, Documentation, Reports & E-books

A powerful markdown-to-PDF engine to render beautiful PDFs with code, math, diagrams & fonts

🌐 Website⁠ • 📚 Aksha Docs⁠ • 💻 GitHub⁠

⁠✨ What is aksha-doc-server?

aksha-doc-server is a document generation microservice that converts Markdown into professional, publication-ready documents.

Whether you're creating:

• 📖 Technical Documentation
• 🎓 Course Materials
• 📑 User Manuals
• 📚 E-books
• 🏢 Company Handbooks
• 📊 Reports
• 💼 Project Documentation
• 🧠 Knowledge Bases

aksha-doc-server helps you generate polished outputs through a simple REST API.

⁠🔥 Features

⁠📄 Document Generation

• Markdown → PDF
• Markdown → DOCX
• Markdown → PPTX
• PDF Merge Utilities
• Professional Document Layouts

⁠🧮 Rich Content Support

• KaTeX Mathematical Equations
• Syntax Highlighted Code Blocks
• Tables
• Images
• Lists
• Callouts
• Custom Styling

⁠⚡ Developer Friendly

• REST API
• Swagger Documentation
• Docker Support
• Lightweight Deployment
• Production Ready

⁠🎯 Built For

• Developers
• Technical Writers
• Educators
• SaaS Founders
• Students
• Businesses

⁠🐳 Docker Deployment

⁠Pull Image

docker pull akash26052005/aksha-doc-server:latest

⁠Run Container

docker run -d \
-p 7860:7860 \
-e PORT=7860 \
-e AKSHA_DOC_MICROSERVICE_DOMAIN_NAME=http://localhost:7860 \
--name aksha-doc-server \
akash26052005/aksha-doc-server:latest

⁠Verify Deployment

Visit:

http://localhost:7860

Expected Response:

{
  "success": true,
  "message": "Aksha Docs Microservice is alive and well 🚀",
  "apiDocs": "http://localhost:7860/docs"
}

⁠⚙️ Environment Variables

Example:

PORT=7860
AKSHA_DOC_MICROSERVICE_DOMAIN_NAME=https://docs.example.com

⁠🚑 Health Check

Endpoint:

GET /health-check

Response:

{
  "success": true,
  "message": "This Microservice is healthy 🥳"
}

Useful for:

• Docker
• Kubernetes
• VPS Monitoring
• Uptime Monitoring
• Load Balancers

⁠📚 API Documentation

Swagger UI:

http://localhost:7860/docs

OpenAPI JSON:

http://localhost:7860/docs.json

⁠🐳 Build Docker Image

docker build -t akash26052005/aksha-doc-server:latest .

Run:

docker run -p 7860:7860 \
-e PORT=7860 \
-e AKSHA_DOC_MICROSERVICE_DOMAIN_NAME=http://localhost:7860 \
akash26052005/aksha-doc-server:latest

⁠💡 Example Use Cases

⁠Technical Documentation

# Hey There! 👋 Welcome to Aksha Doc 🙏

• Unordered Lists
• Ordered Lists
• Tables
• KaTeX Math
• Code Blocks
• Inline Code
• Blockquotes
• Images
• Mermaid Diagrams

⁠🚀 Deploy Anywhere

• Docker
• VPS
• Hugging Face Spaces
• Railway
• Render
• Coolify
• Kubernetes
• Self-hosted Infrastructure

⁠🌐 Creator

⁠Akash Halder

Full Stack Developer • Founder • Technical Writer

• 🌍 Website: https://akashhalder.in⁠
• 🐙 GitHub: https://github.com/Nil369⁠
• 💼 Portfolio: https://akashhalder.in/portfolio⁠

⁠📜 License

MIT License

⁠Built with ❤️ by Akash Halder