md-to-pdf-converter 0.1.0

Convert Markdown files to well-formatted PDF documents

Markdown to PDF Converter

A pip-installable Markdown to PDF converter with a command-line interface built on ReportLab and Matplotlib.

Features

• Converts Markdown files to styled PDF documents
• Supports headings, lists, block quotes, code blocks, tables, images, and math
• CLI with required input and optional output
• Configurable font family
• Configurable color scheme
• Configurable page size

Installation

Install from this project directory:

pip install .

After installation, the CLI command is available as:

md-to-pdf

CLI Usage

md-to-pdf INPUT [OUTPUT] [--font FONT] [--color-scheme {classic,mono,warm}] [--page-size {A4,LETTER,LEGAL}]

Argument Behavior

1. INPUT is required.
2. OUTPUT is optional. If omitted, output is created next to the input file with .pdf suffix.
3. --font can be passed.
4. --color-scheme can be passed.
5. --page-size can be passed.

Examples

Convert with default output path:

md-to-pdf Docs/initial_proposal_v2.md

Convert with explicit output path:

md-to-pdf Docs/initial_proposal_v2.md Docs/initial_proposal_v2_custom.pdf

Convert with custom font:

md-to-pdf Docs/initial_proposal_v2.md --font "Times New Roman"

Convert with warm color scheme and LETTER page size:

md-to-pdf Docs/initial_proposal_v2.md --color-scheme warm --page-size LETTER

Python API Usage

from pathlib import Path
from md_to_pdf import markdown_to_pdf

markdown_to_pdf(
    Path("Docs/initial_proposal_v2.md"),
    Path("Docs/initial_proposal_v2.pdf"),
    font="serif",
    color_scheme="classic",
    page_size_name="A4",
)

Notes

• Dependencies are installed automatically through pip: reportlab, matplotlib
• Image paths in Markdown are resolved relative to the input Markdown file

Publish To PyPI With GitHub Actions (Trusted Publishing)

This repository includes a workflow at .github/workflows/publish-pypi.yml that publishes to PyPI using trusted publishing (OIDC), so no PyPI API token is needed in GitHub secrets.

One-time setup

1. Push this repository to GitHub.
2. In GitHub, create an environment named pypi for the repository.
3. In PyPI, open your project settings and add a trusted publisher with:
   • Owner: your GitHub user/org
   • Repository: this repository name
   • Workflow: publish-pypi.yml
   • Environment: pypi

Release flow

1. Bump version in pyproject.toml (for example from 0.1.0 to 0.1.1).
2. Commit and push.
3. Create a GitHub Release (or publish a release from a tag).
4. The workflow builds and uploads package files to PyPI automatically.

Manual trigger

You can also run the same workflow manually from the Actions tab using workflow_dispatch.