markpdf-cli 0.1.0

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

markpdf-cli

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

Built with markdown and WeasyPrint.

---

✨ Features

• 📄 Convert one or many .md files to PDF in one command.
• 🔀 Merge mode — combine multiple Markdown files into a single PDF with page breaks.
• 🎨 Professional, print-ready CSS styling out of the box.
• 📦 Installable as a Python package; works as a markpdf command.

---

📋 Prerequisites

WeasyPrint depends on system libraries. On Ubuntu / Debian, install them first:

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

On macOS (Homebrew):

brew install pango libffi

---

🚀 Installation

From PyPI (once published)

pip install markpdf-cli

From source

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

Development install

pip install -e .

---

📖 Usage

Convert a single file

markpdf README.md
# → produces README.pdf

Convert a single file with a custom output name

markpdf README.md -o documentation.pdf
# → produces documentation.pdf

Convert multiple files (separate PDFs)

markpdf chapter1.md chapter2.md chapter3.md
# → produces chapter1.pdf, chapter2.pdf, chapter3.pdf

Merge multiple files into one PDF

markpdf chapter1.md chapter2.md chapter3.md --merge
# → produces merged_output.pdf

Merge with a custom output name

markpdf chapter1.md chapter2.md chapter3.md -m -o book.pdf
# → produces book.pdf

Show version

markpdf --version

---

🏗️ Publishing to PyPI

1. Build the package

pip install build
python -m build

This creates dist/markpdf_cli-0.1.0.tar.gz and dist/markpdf_cli-0.1.0-py3-none-any.whl.

2. Upload to TestPyPI

pip install twine
twine upload --repository testpypi dist/*

You'll need an API token from TestPyPI.

3. Verify from TestPyPI

python -m venv /tmp/test-markpdf && source /tmp/test-markpdf/bin/activate
pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ markpdf-cli
markpdf --version
deactivate

4. Upload to production PyPI

twine upload dist/*

---

📄 License

MIT