30-SECOND BRIEF
What it does—and when it fits
Convert Word to Markdown is a GitHub Awesome Copilot workflow that converts DOCX files before analysis instead of parsing zipped XML ad hoc. Its bundled script supports single files, folders, recursive batches, adjacent output folders, and extracted embedded images.
INSTALL BY AGENT
Choose your Agent
Paths come from official Agent docs or the universal installer behind skills.sh. Compatibility still follows this Skill's record.
.agents/skills/convert-word-to-md/~/.copilot/skills/convert-word-to-md/Use project scope for team sharing and personal scope across repositories. The installer defaults to project scope; add -g for personal scope.
npx skills add github/awesome-copilot --skill convert-word-to-md --agent github-copilotCopilot also accepts .github/skills and .claude/skills at project scope. Preview untrusted Skills before enabling scripts.
View path evidence ↗TYPICAL WORKFLOW
A practical workflow
Convert one DOCX
Create Markdown and extracted image assets beside the source by default.
Process document batches
Convert folders recursively while preserving relative structure.
Prepare downstream analysis
Use the Markdown for search, comparison, extraction, review, or summarization.
THE TRADEOFFS
Advantages and tradeoffs
Notable strengths
- Uses one maintained conversion script instead of repeated ad hoc parsers.
- Makes Word content and embedded images easier for agents to inspect.
Limitations
- Supports DOCX but not legacy DOC, password-protected, or corrupt files.
- Markdown conversion can lose complex Word layout, fields, comments, tracked changes, or exact pagination.
BEST FIT
Who it is for
Knowledge workers preparing Word files for agent analysis
Teams batch-indexing reports, proposals, contracts, or resumes
BEFORE YOU USE IT
Risks to review before use
Sensitive document duplication
Conversion creates Markdown and image copies beside the source by default. Confirm the destination, access controls, retention policy, and whether confidential images may be extracted.
SECURITY
What the permission profile means
- Treat converted Markdown and image folders with the same classification as the source document.
- Review extracted text and images before sharing because hidden or incidental content may surface.
Not a security certification. External ratings are attributed references. SkillSignal has not independently executed or security-reviewed this Skill.
INSIDE THE PACKAGE
Indexed files
TAGS
Original SkillSignal editorial profile grounded in GitHub Awesome Copilot commit 318066d2, checked 2026-08-20; not independently executed or security-certified.