md2pdflisted
Install: claude install-skill nogunix/janus
# md2pdf
Convert Markdown to a print-ready PDF with proper Japanese (CJK) font rendering,
styled tables, syntax-highlighted code blocks, and embedded images/SVGs.
## When to use
- "PDFにして", "PDF作成して", "mdからPDF生成"
- "このマークダウンをPDFに変換"
- "レポートをPDFで出力"
- janus synthesize の `report.md` → `report.pdf` 最終出力
## Prerequisites (install if missing)
- `pandoc` (brew / apt)
- `weasyprint` (brew / pip)
Quick check: `pandoc --version && weasyprint --version`
All helper files live in `scripts/` and `css/` next to this file.
## Workflow
### 1. Convert with the bundled CSS
```bash
scripts/md2pdf.sh INPUT.md OUTPUT.pdf
```
This runs pandoc with weasyprint as the PDF engine, using the bundled
`css/default.css` for Japanese font support and clean typography.
The script auto-detects the CSS path relative to itself, so it works from
any working directory.
### 2. Convert with a custom CSS
```bash
scripts/md2pdf.sh INPUT.md OUTPUT.pdf --css /path/to/custom.css
```
### 3. Programmatic usage (from Claude)
```bash
SKILL_DIR="$(dirname "$(realpath "$0")")"
pandoc INPUT.md -o OUTPUT.pdf \
--pdf-engine=weasyprint \
--css="$SKILL_DIR/css/default.css"
```
### 4. Verify the output
Open the PDF and check:
- Japanese text renders correctly (not Chinese glyphs)
- Tables have borders and proper alignment
- Code blocks have background shading
- Images/SVGs are embedded and sized correctly
## CSS customization
The bundled `css/default.css` provides:
- **Fonts**: Hiragino Kaku Gothic ProN (macOS