docxport

Document Export

Convert documents (Markdown, HWP, DOCX, RTF) to PDF, PNG, HTML slides.

Usage mandate (HARD STOP)

All Markdown | HWP | DOCX → PDF / PNG / HTML / DOCX conversion must go through this skill. Do not assemble pandoc / prince / md-to-pdf / soffice commands ad-hoc — direct assembly repeats mistakes (duplicated titles, watermark leakage on official documents, missing images on HWP txt fallback, etc.).

Topics

Pandoc (Markdown → PDF / PNG) is the underlying tool for §4 Execution — not a separate topic. See §2 Tool priority + §4 Execution.

Quick Start

/docxport path/to/document.md

Instructions

1. Classify the target medium (MANDATORY — before tool selection)

Before picking a converter, classify the deliverable into one of the two mediums below. The medium decides which tool is legal, not which tool is available.

If the user has not stated the medium explicitly, default to "Official / external" — false positives (watermark-clean tool used on a scratch draft) waste nothing; false negatives (watermarked prince output emailed to a customer) are unrecoverable.

2. Tool priority (fallback order)

Use the first available tool that satisfies the medium classification from §1. Skip any tool marked "internal only" if the medium is Official / external.

Rank rationale:

• LibreOffice is #1 because it is watermark-clean, MPL-licensed, and handles the widest input format list (Markdown via pandoc pre-step, DOCX, HWP, RTF, ODT). It is the only converter that can render HWP without loss.
• prince is dropped to internal-only because the free build stamps every page. Paid Prince removes the stamp but is per-machine licensed — do not silently rely on user's paid seat.
• md-to-pdf is a valid watermark-clean alternative on Windows / npm-heavy machines but pulls Chromium on first run, so LibreOffice remains #1 on macOS / Linux.

3. LibreOffice install-check + install-ask procedure (MANDATORY)

Before every LibreOffice-backed conversion:

if command -v soffice >/dev/null 2>&1 || command -v libreoffice >/dev/null 2>&1; then
  echo "LibreOffice available"
else
  echo "LibreOffice NOT installed"
fi

If not installed, do NOT silently fall through to prince / md-to-pdf when the medium is Official / external. Instead:

1. Run AskUserQuestion with these options (single-select):
   • Install LibreOffice (~400MB, Recommended for official documents) — description mentions brew install --cask libreoffice (macOS) or scoop install libreoffice (Windows) or apt install libreoffice (Linux). Runtime ~2–10 min depending on network
   • Fall back to next watermark-clean rank (wkhtmltopdf / xelatex / md-to-pdf) — if any is available. State which one and its trade-off
   • Downgrade medium to Internal-only and use prince — only offer when the user is willing to accept the watermark
2. Wait for the answer. Do NOT proceed with prince output on an Official-medium document without explicit user approval.
3. If the user selects install: run the appropriate install command in the appropriate way for the platform, then verify with the check command above before continuing.

Don't / Do

4. Execution

Method A — LibreOffice (default, watermark-clean)

md → pdf chain (LibreOffice can't read .md directly, so pandoc pre-converts to docx):

pandoc document.md -o document.docx --toc -V lang=ko-KR
soffice --headless --convert-to pdf --outdir "$OUTDIR" document.docx
# → document.pdf (watermark-free, faithful to Word-style layout)

Direct format conversions (LibreOffice reads these natively):

soffice --headless --convert-to pdf --outdir "$OUTDIR" input.docx
soffice --headless --convert-to pdf --outdir "$OUTDIR" input.hwp
soffice --headless --convert-to pdf --outdir "$OUTDIR" input.rtf
soffice --headless --convert-to html --outdir "$OUTDIR" input.hwp   # HTML with images extracted

Method B — pandoc + prince (Internal only; do NOT use for Official)

# Only when medium classification = Internal AND the user has not asked for a watermark-clean output
pandoc document.md -f gfm -t html5 -s -c style.css -o document.html
prince document.html -o document.pdf

PNG rendering (PDF → PNG page images)

pdftoppm -png -r 150 document.pdf document

5. HWP / legacy document conversion (integrated procedure)

HWP (Hangul Word Processor) is a Korean office format frequently used in official Korean government / enterprise submissions.

Toolchain by input format

Analysis-request default (HARD STOP)

When the user asks to analyze a rich-format document (HWP / DOCX / PDF / legacy) without specifying the output medium:

Sanitized filename workaround

LibreOffice sometimes fails on paths with Korean characters + spaces. If soffice --convert-to pdf "" returns "source file could not be loaded":

cp "$ORIGINAL" /tmp/input.hwp
soffice --headless --convert-to pdf --outdir /tmp /tmp/input.hwp
# then rename output back to the original stem if needed

Conversion cautions (recurrence prevention)

Title — no duplication

• If the document already contains # H1, do NOT append --metadata title="..." to pandoc. -s emits a separate title block that duplicates the H1 → two-line duplicated title. Use H1 as the sole title.
• If a separate title block is required, remove the # H1 from the source and keep only --metadata title (one or the other, never both).

Change-highlight documents (`` for review)

Do not delete review artifacts

Review PDFs / MDs awaiting user approval are kept until the user explicitly confirms review is complete (see file-operations.md .tmp section). No auto-cleanup.

Tool inventory

Output files

• document.pdf — PDF
• document.html — HTML (with image assets when converted from HWP / DOCX)
• document-1.png, document-2.png, ... — per-page PNG

Options

PNG resolution

pdftoppm -png -r 300 document.pdf document  # 300 DPI (high resolution)
pdftoppm -png -r 72  document.pdf document   # 72 DPI (low resolution)

Merge PNGs into one

# Requires ImageMagick
convert document-*.png -append document-all.png