Md2pdf

md2pdf

Convert Markdown to PDF with template selection.

Prerequisites

• pandoc installed
• xelatex installed (via MacTeX on macOS: /Library/TeX/texbin/xelatex)

Verify before running:

command -v pandoc && (command -v xelatex || test -x /Library/TeX/texbin/xelatex)

Templates

Template files: assets/templates/

Usage

The conversion script is at scripts/md2pdf.sh inside this skill's directory. Use the skill's base directory (provided at load time) to build the absolute path. Examples below use $SKILL_DIR as a placeholder — resolve it from the base directory shown in the system prompt.

# Single file — default template (sourcesense), portrait
$SKILL_DIR/scripts/md2pdf.sh docs/specs/architecture.md

# Single file — standard template
$SKILL_DIR/scripts/md2pdf.sh --template standard deploy_notes/guida-deploy-produzione.md

# Single file — landscape (for docs with wide tables)
$SKILL_DIR/scripts/md2pdf.sh --landscape docs/planning/journal.md

# Combined: standard template + landscape
$SKILL_DIR/scripts/md2pdf.sh --template standard --landscape input.md /tmp/output.pdf

# Batch mode — all project docs
$SKILL_DIR/scripts/md2pdf.sh --all

# Batch mode — standard template, landscape
$SKILL_DIR/scripts/md2pdf.sh --all --template standard --landscape

Options

Output goes to pdf/output/ (relative to project root) by default.

Workflow

1. Ensure the markdown file has no LaTeX-incompatible syntax:
   • Replace - [ ] checkbox markers with - ▢ (U+25A2) or plain -
   • Verify image paths are relative to the document directory
2. Run the script with the chosen template
3. Check exit code — non-zero means conversion failed
4. PDF is written to pdf/output/<filename>.pdf unless a custom path is given

Markdown Features Supported

• Pipe tables (| col | col |)
• Fenced code blocks with syntax highlighting (Tango theme)
• Auto-generated heading IDs
• Table of contents (depth 3 by default)
• Inline images (resolved from document directory, images/ subdirs, and skill's assets/logo/)

Troubleshooting