markpdf-cli 0.1.1

A fast, clean CLI tool to convert Markdown files into beautifully styled PDFs.

📄 markpdf-cli

Convert Markdown to beautifully styled PDFs — from the terminal.

---

markpdf-cli is a lightweight command-line tool that takes your .md files and produces clean, print-ready PDF documents with professional styling — no configuration needed.

Built with python-markdown for parsing and WeasyPrint for rendering.

---

⚡ Quick Start

pip install markpdf-cli
markpdf README.md

That's it. You now have a README.pdf with beautiful typography and styling.

---

🚀 Installation

From PyPI

pip install markpdf-cli

From source

git clone https://github.com/therivalkiller/markpdf-cli.git
cd markpdf-cli
pip install .

System dependencies

WeasyPrint requires some system libraries. Install them before using markpdf:

Ubuntu / Debian

sudo apt update
sudo apt install -y libpango-1.0-0 libpangocairo-1.0-0 libgdk-pixbuf2.0-0 libffi-dev libcairo2

macOS (Homebrew)

brew install pango libffi

---

📖 Usage

Convert a single file

markpdf report.md
# → report.pdf

Custom output name

markpdf report.md -o final-report.pdf
# → final-report.pdf

Convert multiple files (separate PDFs)

markpdf ch1.md ch2.md ch3.md
# → ch1.pdf  ch2.pdf  ch3.pdf

Merge multiple files into one PDF

markpdf ch1.md ch2.md ch3.md --merge
# → merged_output.pdf  (page breaks between each file)

Merge with a custom name

markpdf ch1.md ch2.md ch3.md -m -o book.pdf
# → book.pdf

---

🐍 Use as a Python library

You can also import markpdf directly in your scripts:

from markpdf.converter import convert_single, convert_merged

# Single file
convert_single("notes.md", "notes.pdf")

# Merge multiple files
convert_merged(["ch1.md", "ch2.md", "ch3.md"], "book.pdf")

---

🏗️ Project Structure

markpdf-cli/
├── pyproject.toml          # Build config & metadata
├── README.md
├── .gitignore
└── src/
    └── markpdf/
        ├── __init__.py     # Version
        ├── cli.py          # CLI entry point (argparse)
        └── converter.py    # Core MD → HTML → PDF logic

---

🤝 Contributing

Contributions are welcome! Feel free to open an issue or submit a pull request.

git clone https://github.com/therivalkiller/markpdf-cli.git
cd markpdf-cli
pip install -e .

---

📄 License

MIT © Amritanshu