MarkdownForge

MarkdownForge

April 2025

About the Project

Transform your Markdown files into elegantly styled PDF documents with a single click. MarkdownForge is a powerful yet simple web application that converts your Markdown files into beautifully formatted PDF documents, preserving all your content's structure and styling.

MarkdownForge is a powerful yet simple web application that converts your Markdown files into beautifully formatted PDF documents, preserving all your content's structure and styling.

✨ Features

  • Effortless Conversion - Upload and convert Markdown files to PDF in seconds
  • Faithful Formatting - Preserves headings, lists, code blocks, and text styling
  • Multiple Input Formats - Supports .md, .markdown, and .txt files
  • Elegant Output - Creates professional-looking PDF documents with customizable styling
  • Web-Based Interface - No software installation required, accessible from any device
  • Fast & Reliable - Built with performance and stability in mind

🚀 Getting Started

Online Service

Visit https://markdownforge.onrender.com/ to use the tool online.

Local Development

  1. Clone the repository
    git clone https://github.com/sculptorofcode/markdownforge.git
    cd markdownforge
    
  2. Install dependencies
    pip install -r requirements.txt
    
  3. Run the application
    python app.py
    
  4. Access MarkdownForge
    Open your browser and navigate to http://localhost:5000

🛠️ Deployment

MarkdownForge can be easily deployed to Render:
  1. Push your repository to GitHub
  2. Log in to your Render account
  3. Create a new Web Service
  4. Connect to your GitHub repository
  5. Configure your service:
    • Build Command: pip install -r requirements.txt
    • Start Command: gunicorn app:app
  6. Set any necessary environment variables
  7. Deploy the service

📋 Usage Guide

  1. Click the "Choose File" button to select your Markdown file
  2. Press "Convert" to transform your file
  3. Download your beautifully formatted PDF
  4. Enjoy your professional-looking document!

🔧 Advanced Options

  • Customize page margins and styling
  • Choose from different themes or create your own
  • Set document properties including title, author, and keywords
  • Configure header and footer options

💡 Coming Soon

  • Batch processing of multiple files
  • Custom CSS styling options
  • Real-time preview
  • API access for programmatic conversions

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

MarkdownForge - Crafting beautiful documents from simple Markdown.

Comments

No comments yet. Be the first to share your thoughts!

Technologies Used

PythonJavaScriptHTMLCSS