export-pdf

Export PDF — Markdown to PDF Converter

Convert a markdown file to a styled PDF using mdpdf.

Process

1. Parse arguments

If $ARGUMENTS is empty, ask the user for the markdown file path. If provided, use it directly (e.g., /brana:export-pdf propuesta-integracion-payway.md).

2. Resolve path

Resolve the file path:

• If relative, resolve against $PWD
• Validate the file exists and has .md extension
• If the file doesn't exist, suggest matches using Glob with **/*{slug}*.md

3. Pre-render Mermaid blocks

Check if the source file contains any Mermaid code blocks:

grep -c '```mermaid' "{source_file}"

If count is 0: skip this step — no Mermaid blocks found. render_source = {source_file}.

If count > 0:

1. Resolve mmdc:

   mmdc_bin=$(which mmdc 2>/dev/null)
   

   If empty, warn the user: "Mermaid blocks found but mmdc is not installed — they will render as raw code. Install with: npm install -g @mermaid-js/mermaid-cli then ln -sf $(which mmdc) ~/.local/bin/mmdc". Set render_source = {source_file} and skip to step 4.

2. Create a temp workspace and copy the source:

   tmp_dir=$(mktemp -d)
   tmp_md="${tmp_dir}/$(basename '{source_file}')"
   cp "{source_file}" "$tmp_md"
   

3. Write Puppeteer config — required on Ubuntu 23.10+ due to AppArmor namespace restrictions:

   cat > "${tmp_dir}/puppeteer.json" <<'EOF'
   {"args":["--no-sandbox","--disable-setuid-sandbox"]}
   EOF
   

4. Extract and render each block, replacing it with an image reference. Pass $mmdc_bin as a third argument so the Python subprocess uses the resolved path:

   uv run python3 - "$tmp_md" "$tmp_dir" "$mmdc_bin" <<'PYEOF'
   import re, subprocess, sys
   from pathlib import Path
   
   src = Path(sys.argv[1])
   tmp = Path(sys.argv[2])
   mmdc_cmd = sys.argv[3]  # resolved from PATH
   content = src.read_text()
   puppeteer_cfg = tmp / "puppeteer.json"
   pattern = re.compile(r'```mermaid\n(.*?)```', re.DOTALL)
   
   def render_block(match, idx):
       diagram = match.group(1).strip()
       mmd = tmp / f"diagram_{idx}.mmd"
       png = tmp / f"diagram_{idx}.png"
       mmd.write_text(diagram)
       r = subprocess.run(
           [mmdc_cmd, "-i", str(mmd), "-o", str(png), "-p", str(puppeteer_cfg)],
           capture_output=True, text=True
       )
       if r.returncode != 0:
           print(f"[warn] mmdc failed for block {idx}: {r.stderr.strip()}", file=sys.stderr)
           return match.group(0)  # keep original block on failure
       return f"![]({png})"
   
   counter = [0]
   def repl(m):
       counter[0] += 1
       return render_block(m, counter[0])
   
   new_content = pattern.sub(repl, content)
   src.write_text(new_content)
   print(f"Rendered {counter[0]} Mermaid block(s)")
   PYEOF