# Md2pdf

> Md2pdf is an Agent Skill for documents published in the joshukraine/dotfiles repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Convert a Markdown file to PDF with GitHub-style formatting using the md2pdf tool.

- Skill name: `md2pdf`
- Category: [Documents](https://www.openparable.com/skill/documents/1)
- Source: https://github.com/joshukraine/dotfiles/blob/HEAD/claude/.claude/skills/md2pdf/SKILL.md
- Repository: joshukraine/dotfiles (421 GitHub stars when collected)

## SKILL.md

# Markdown to PDF

Convert Markdown files to PDF with GitHub-style formatting using the `md2pdf` tool.

## Command Options

- `$ARGUMENTS`: File paths or glob patterns to convert (e.g., `docs/guide.md`, `docs/*.md`)
- `-o FILE`: Custom output path (only valid with a single input file)

## Your task

1. **Determine input files**:
   - If `$ARGUMENTS` are provided, use them as the file paths
   - If no arguments are provided, ask the user which files to convert

2. **Run the conversion**: Execute `md2pdf` with the specified files

3. **Report results**: Confirm which PDFs were generated

## Tool Details

The `md2pdf` tool uses pandoc + weasyprint with GitHub-style CSS. The CSS and script live in dotfiles (`~/dotfiles/bin/.local/bin/`). The `MD2PDF_CSS` environment variable can override the default CSS path.

## Example Usage

```bash
# Convert a single file
/md2pdf docs/guide.md

# Convert multiple files with a glob
/md2pdf docs/qa-handoffs/qa-guide-*.md

# Convert with a custom output name
/md2pdf -o custom-name.pdf docs/guide.md
```

---

Source: https://www.openparable.com/skill/documents/md2pdf (OpenParable). Cite the canonical URL above.