md2resume-pitfalls · Resume-to-DOCX Pitfall Guard
md2resume-pitfalls: a failure-mode protection layer for converting Markdown resumes to one-page DOCX. Paired with the main md2resume skill: this skill is the process-and-pitfall layer (font pollution, pagination overflow, privacy leaks, lost tmp scripts, editor lock files, deliverable impurities); the main skill is the Markdown-dialect and renderer-map layer.
Core rules: Markdown is the only content source; the reference DOCX is a layout skeleton only; deliver exactly one inspected DOCX — PDF/PNG/HTML only in temp dirs for visual QA, deleted before delivery. Includes one-page calibration practice (scale tuning, compressing redundant copy before shrinking type) and template font fixes ("Courier" → Arial, leaving "Courier New" alone).
Example invocation: "Convert this resume to a one-page DOCX without the usual pitfalls."
Full brief
Positioning
md2resume-pitfalls is a pitfall-protection layer for Markdown-to-one-page-DOCX resume conversion: paired with the main md2resume skill. This skill is the process and failure-mode layer; the main skill is the Markdown-dialect and renderer-map layer.
Core capabilities
- Reference-template clone path:
build_docx_from_reference.py input.md --reference template.docx --output out.docx --scale X. - Deliverable purity: exactly one inspected DOCX; PDF/PNG/HTML only as temporary visual QA, deleted before delivery; source Markdown, scripts, and the desensitized template are never deleted.
- One-page calibration: re-measure after content grows; compress redundant copy and paragraph spacing first, then lower
--scalein small steps (this project's experience: 0.95 overflowed, 0.90 fit); body type never shrinks past readability. - Template & fonts: keep the template's name hierarchy, blue rules, light-blue result bars, left blue accent, photo slot, and margins; bold 1–2 keywords per bullet, never whole sentences; a bare
"Courier"in fontTable becomesArial,"Courier New"stays; highlight only the last achievement of each experience block. - Privacy protection: confirm the committed template carries no real name, phone, WeChat, email, or photo; real photos pass only through an external
--referencefile; the in-repo template stays a fake-name silhouette sample. - Lock-file handling: close the target file or use a new output name when WPS/Word has it open; run
check_output_ready.pywhen the path may be locked. - Page-count verification: one-page claims require Word/LibreOffice render checks; never infer page count from Markdown length.
Workflow
- Inspect source Markdown, reference template, output path (confirm no real PII in template)
- Reference-template clone build (
--scalecalibration) - Verify content, font XML, page count, visual layout
- Clean the delivery directory (only
.docxremains) - Deliver
Inputs & outputs
| Input | Notes |
|---|---|
| Markdown resume | Required — the only content source |
| Reference template DOCX | Desensitized template (fake name, no real contact/photo) |
| --scale | One-page calibration parameter |
Output: one inspected DOCX (delivery directory contains only .docx).
Boundaries with adjacent skills
| Skill | Lane |
|---|---|
| md2resume-pitfalls (this) | Process and pitfall-protection layer |
| md2resume | Markdown-dialect and renderer-map layer (paired use) |
Fit
- Chinese one-page resumes to DOCX
- Avoiding known pitfalls (template font pollution, pagination overflow)
- Explicit DOCX-only delivery requirements
Before you start
- Prepare the Markdown resume and a desensitized reference template.
- Close the target file in WPS/Word (or rename output) when it's open.
md2resume-pitfalls is part of the Aiglade Skill library. Invoke it from the Aiglade chat box in plain language.