Skip to main content

A CLI tool that converts Markdown files into beautifully themed PDFs with syntax-highlighted code blocks.

Project description

codeDown

PyPI version Python versions License: MIT Build Status Docs

codeDown is a simple yet powerful CLI tool that converts Markdown (.md) files into beautiful themed PDFs — complete with syntax-highlighted code blocks.

Built for developers who love clean documentation, readable code snippets, and automated workflows.


Features

  • Syntax Highlighting for code blocks
  • Selectable Themes – interactive picker or CLI flag (light, dark)
  • Watch Mode – auto-regenerate PDF on file save
  • Self-Update – update from the CLI (code-down update)
  • Configurable – set a default theme via code-down config set-theme
  • Fast & Lightweight – converts Markdown to PDF in seconds

Installation

Via pip

pip install code-down

Via binary (Linux)

  1. Download the latest release Visit the Releases Page and download the latest Linux binary.

  2. Make it executable and move to PATH

    chmod +x code-down
    sudo mv code-down /usr/local/bin/
    

Usage

Convert a Markdown file into a themed PDF:

code-down input.md output.pdf -s dark

Watch mode

Automatically rebuild the PDF when the Markdown file changes:

code-down -w input.md

Options

Flag Description Default
-o, --output Output PDF file path Same as input with .pdf extension
-s, --style Theme style (e.g. light, dark) Config default or dark
-w, --watch Watch file and rebuild PDF on changes
-v, --version Print version and exit

Commands

Command Description
code-down themes Pick a theme interactively (sets as default)
code-down config show Show current configuration
code-down config set-theme Set the default theme (interactive or by name)
code-down update Update codeDown to the latest version

Examples

Quick test file:

code-down examples/example.md

Convert README.md to README.pdf using the default theme:

code-down README.md

Convert with a dark theme and custom output name:

code-down README.md -o README_dark.pdf -s dark

Watch a file and rebuild on every save:

code-down -w notes.md -s light

Pick a theme interactively:

code-down themes

Notes

  • Ensure your Markdown files are UTF-8 encoded for best results.
  • Supports syntax highlighting for most major programming languages.
  • Works completely offline — no internet connection required (except for update).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

code_down-2.0.3.tar.gz (12.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

code_down-2.0.3-py3-none-any.whl (14.9 kB view details)

Uploaded Python 3

File details

Details for the file code_down-2.0.3.tar.gz.

File metadata

  • Download URL: code_down-2.0.3.tar.gz
  • Upload date:
  • Size: 12.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for code_down-2.0.3.tar.gz
Algorithm Hash digest
SHA256 6db57339d1351d99718efbb32dc332eed0483c43da47af6a950ac80148d96b9c
MD5 1b194690056f2bfe3bddd645272b2c17
BLAKE2b-256 c2a2d95f95009e09767c13b912924870be8d4ed2ad358538b39786cd3b13001b

See more details on using hashes here.

File details

Details for the file code_down-2.0.3-py3-none-any.whl.

File metadata

  • Download URL: code_down-2.0.3-py3-none-any.whl
  • Upload date:
  • Size: 14.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for code_down-2.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 e3e20af98de72ea5017f039715c9f142caca0ba1b1e968c3d9e25687ce0b6609
MD5 71348469a1caf7df1a022d9aff1b97dc
BLAKE2b-256 89327245cc741d93e92e026509546da2904abb39a9aab030ea730750a6ac40cf

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page