How do I install the Z Md To Word skill?

Run npx skillmds@latest add tjxj/z-md-to-word in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Z Md To Word safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Z Md To Word?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Z Md To Word free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Z Md To Word?

tjxj (@tjxj) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Z Md To Word by tjxj — Agent Skill

Name: Z Md To Word
Author: tjxj

Z Md To Word

Convert local Markdown files into Word documents. Use this skill whenever the user provides a .md path and says 转成doc, 转成 Word, Markdown 转 Word, Markdown转doc, md 转 doc, md转docx, 导出 Word, 生成 doc, 生成 docx, or asks for a Word version of an article. This skill should produce a .docx by default, also produce a legacy .doc when useful, embed valid images, skip empty upload placeholders, keep Markdown lists readable, write outputs under output/doc, and verify the generated files before reporting.

tjxj Updated Sep 17, 2026

File contents

Markdown to Word

Use This For

A local .md article needs to become a Word file.
The user says "转成doc", "转成 Word", "md 转 doc", "Markdown 转 Word", "导出 Word", or similar.
The input is usually an Obsidian or WeChat article with YAML frontmatter and remote images.

Completion Standard

Finish only after all of these are true:

The .docx file exists under output/doc/.
If the user asked for .doc, a legacy .doc file also exists.
The document can be opened or rendered by LibreOffice.
The extracted text includes representative beginning, middle, and ending content.
Valid images are embedded; empty upload placeholders like ![]( ) or ![Uploading file...]() are skipped.
Markdown lists are readable as lists, even when the source omitted a blank line before -.

Preferred Command

From the workspace root:

python3 .agent/skills/z-md-to-word/scripts/md_to_word.py "/absolute/path/to/article.md"

The script writes outputs to:

output/doc/<markdown-stem>.docx
output/doc/<markdown-stem>.doc

Use --no-doc only when the user explicitly wants .docx only.

Workflow

Confirm the Markdown file exists.
Run the bundled script.
Read the JSON summary printed by the script.
If rendered_docx or rendered_doc is false, fix the cause and rerun.
If layout quality matters, rerun with --keep-render, open the generated contact sheet, and inspect the pages.
Report only the final file paths and the verification result.

Details Captured By The Script

Uses Pandoc with markdown+yaml_metadata_block+lists_without_preceding_blankline.
Preserves frontmatter title, author, and date as Word document metadata/title block.
Removes empty image nodes before conversion, so upload placeholders do not appear in the final document.
Embeds valid local or remote images into the .docx.
Converts .docx to .doc through LibreOffice when available.
Validates the .docx ZIP structure.
Extracts plain text for a content sanity check.
Renders Word files to PDF when LibreOffice is available.

Fallback

If the script cannot run, use this direct conversion pattern:

pandoc "input.md" \
  --from markdown+yaml_metadata_block+lists_without_preceding_blankline \
  --to docx \
  --standalone \
  --resource-path="/path/to/input-dir:/workspace/root" \
  --lua-filter="/tmp/remove-empty-images.lua" \
  --output "output/doc/name.docx"

/tmp/remove-empty-images.lua:

function Image(img)
  if img.src == "" then return {} end
end

Then render and inspect:

soffice -env:UserInstallation=file:///tmp/lo_profile_$$ \
  --headless --convert-to pdf --outdir tmp/docs/check "output/doc/name.docx"

---name: z-md-to-worddescription: Convert local Markdown files into Word documents. Use this skill whenever the user provides a .md path and says 转成doc, 转成 Word, Markdown 转 Word, Markdown转doc, md 转 doc, md转docx, 导出 Word, 生成 doc, 生成 docx, or asks for a Word version of an article. This skill should produce a .docx by default, also produce a legacy .doc when useful, embed valid images, skip empty upload placeholders, keep Markdown lists readable, write outputs under output/doc, and verify the generated files before reporting.---# Markdown to Word## Use This For- A local `.md` article needs to become a Word file.- The user says "转成doc", "转成 Word", "md 转 doc", "Markdown 转 Word", "导出 Word", or similar.- The input is usually an Obsidian or WeChat article with YAML frontmatter and remote images.## Completion StandardFinish only after all of these are true:- The `.docx` file exists under `output/doc/`.- If the user asked for `.doc`, a legacy `.doc` file also exists.- The document can be opened or rendered by LibreOffice.- The extracted text includes representative beginning, middle, and ending content.- Valid images are embedded; empty upload placeholders like `![]( )` or `![Uploading file...]()` are skipped.- Markdown lists are readable as lists, even when the source omitted a blank line before `-`.## Preferred CommandFrom the workspace root:```bashpython3 .agent/skills/z-md-to-word/scripts/md_to_word.py "/absolute/path/to/article.md"```The script writes outputs to:```textoutput/doc/<markdown-stem>.docxoutput/doc/<markdown-stem>.doc```Use `--no-doc` only when the user explicitly wants `.docx` only.## Workflow1. Confirm the Markdown file exists.2. Run the bundled script.3. Read the JSON summary printed by the script.4. If `rendered_docx` or `rendered_doc` is false, fix the cause and rerun.5. If layout quality matters, rerun with `--keep-render`, open the generated contact sheet, and inspect the pages.6. Report only the final file paths and the verification result.## Details Captured By The Script- Uses Pandoc with `markdown+yaml_metadata_block+lists_without_preceding_blankline`.- Preserves frontmatter title, author, and date as Word document metadata/title block.- Removes empty image nodes before conversion, so upload placeholders do not appear in the final document.- Embeds valid local or remote images into the `.docx`.- Converts `.docx` to `.doc` through LibreOffice when available.- Validates the `.docx` ZIP structure.- Extracts plain text for a content sanity check.- Renders Word files to PDF when LibreOffice is available.## FallbackIf the script cannot run, use this direct conversion pattern:```bashpandoc "input.md" \ --from markdown+yaml_metadata_block+lists_without_preceding_blankline \ --to docx \ --standalone \ --resource-path="/path/to/input-dir:/workspace/root" \ --lua-filter="/tmp/remove-empty-images.lua" \ --output "output/doc/name.docx"````/tmp/remove-empty-images.lua`:```luafunction Image(img) if img.src == "" then return {} endend```Then render and inspect:```bashsoffice -env:UserInstallation=file:///tmp/lo_profile_$$ \ --headless --convert-to pdf --outdir tmp/docs/check "output/doc/name.docx"```

Frequently asked questions