md-2-pdf

Convert markdown files to clean, formatted PDFs using reportlab

Security Scan

The skill's code and runtime instructions align with its stated purpose (converting Markdown to PDF), request no secrets, and contain no obvious surprising behavior.

Purpose & Capability

Name/description ask for Markdown→PDF conversion and the package provides a Python script that uses reportlab for PDF generation. The declared required binary 'uv' matches the script shebang which runs via 'uv run'; this dependency is coherent with how the script is invoked.

Instruction Scope

SKILL.md only tells the agent to run the included script with uv and to pass input/output flags. It does not instruct the agent to read unrelated files, environment variables, or send data to external endpoints. The script parses markdown and constructs PDF elements (headers, lists, code blocks, tables, images) which is consistent with the feature list.

Install Mechanism

There is no install spec (instruction-only) which minimizes disk write risk. The script contains a comment listing a runtime dependency ('reportlab'); how that dependency is installed at runtime depends on the host's 'uv' runner. This is reasonable but you should confirm how your environment resolves Python dependencies when running 'uv run'.

Credentials

The skill requires no environment variables or credentials. The script operates on local files (markdown and referenced image paths) which is expected for a converter. No unrelated secrets or tokens are requested.

Persistence & Privilege

always is false and the skill does not request persistent system-wide privileges. It does not modify other skills or global agent settings. Autonomous model invocation is allowed (default) but that is normal and acceptable here.

Assessment

This skill appears coherent and focused on converting Markdown to PDF. Before installing: (1) Verify the 'uv' runner on your system is the expected/trusted tool and understand how it installs Python dependencies (it may auto-install reportlab); (2) be aware the converter will read local files referenced by the markdown (images, etc.); (3) run it on non-sensitive sample files first to confirm behavior. If you require stricter isolation, run the script in a sandbox or inspect the full script in your environment before use.

Markdown to PDF

Convert markdown documents to professional, clean PDFs with proper formatting.

Usage

# Basic usage
uv run scripts/md-to-pdf.py input.md

# Specify output
uv run scripts/md-to-pdf.py input.md -o output.pdf
uv run scripts/md-to-pdf.py input.md --output my-report.pdf

# Verbose mode
uv run scripts/md-to-pdf.py input.md -v

Features

• Headers: H1-H6 with hierarchical styling
• Text formatting: Bold, italic, inline code
• Lists: Bullet lists, numbered lists, task lists
• Code blocks: Syntax highlighting with background
• Tables: Full table support with headers
• Links: Clickable hyperlinks
• Horizontal rules: Visual section dividers
• YAML frontmatter: Automatically skipped
• Special characters: Emojis, Unicode symbols
• Page numbers: Automatic footer with page numbers
• Professional styling: Clean, readable output

Options

• -o, --output: Output PDF file path (default: input_filename.pdf)
• -v, --verbose: Print detailed processing information

Supported Markdown Elements

Element	Syntax	Status
Headers	# H1 to ###### H6	✅
Bold	**text** or __text__	✅
Italic	*text* or _text_	✅
Inline code	`code`	✅
Code blocks	```	✅
Bullet lists	- item or * item	✅
Numbered lists	1. item	✅
Task lists	- [x] done	✅
Tables	`	col
Links	[text](url)	✅
Horizontal rules	--- or ***	✅
Blockquotes	> quote	✅