comol/ai_rules_1c/md-to-docx

md-to-docx — Markdown to DOCX conversion

Converts a Markdown file to a Word document (.docx) preserving headings, tables, lists, code blocks, links and inline images.

Usage

/md-to-docx <input.md> [output.docx] [--author "Name"] [--title "Title"] [--no-shading] [--justify]

If the path is not provided — ask the user. The --author, --title, --no-shading, --justify flags are optional — pass them only when the user explicitly asks for an author, a custom title, removal of code shading, or justified text.

Dependencies

• Node.js — to run the script
• npm package `docx` — pinned by this skill's package-lock.json; install locally with npm ci --prefix "<skill-dir>"

Command

<skill-dir> below is the directory of this skill: content/skills/md-to-docx/ in the 1c-rules source repo, or <tool>/skills/md-to-docx/ after installation (e.g. .cursor/skills/md-to-docx/, .claude/skills/md-to-docx/).

PowerShell (Windows, default for this project):

npm ci --prefix "<skill-dir>"
node "<skill-dir>/scripts/md_to_docx.js" "<input.md>" "[output.docx]"
 
# With author and title
node "<skill-dir>/scripts/md_to_docx.js" "<input.md>" "[output.docx]" --author "I. Ivanov" --title "Analytical note"
 
# Without the grey code background
node "<skill-dir>/scripts/md_to_docx.js" "<input.md>" "[output.docx]" --no-shading
 
# With justified body text
node "<skill-dir>/scripts/md_to_docx.js" "<input.md>" "[output.docx]" --justify

Bash (macOS / Linux):

npm ci --prefix "<skill-dir>"
node "<skill-dir>/scripts/md_to_docx.js" "<input.md>" "[output.docx]"

Supported Markdown features

• Headings (H1–H6) with styles and colors; a heading stays with the following paragraph (keepNext)
• Tables with header row
• Code blocks (monospace font, gray background)
• Lists: bulleted and numbered (with nesting); wrapped continuation lines join the same item. Each numbered list, including nested lists and lists inside quotes, starts at its first source ordinal (4. starts at 4); subsequent markers such as repeated 1. continue that list. Blank lines between items keep a list together; a separate paragraph or another block ends it
• Block quotes (>): marker stripped, wrapped lines joined, nested lists kept; left bar + indent
• Paragraphs: hard-wrapped lines join until a blank line or the next block (heading, list, table, quote, fence, hr, image)
• Inline formatting: bold, italic, code, links
• Internal anchor links: <a id="name"></a> before a heading becomes a bookmark; [text](#name) links resolve to it (external http(s) / mailto: links stay external)
• Images (![alt](path)) — resolved relative to the source MD folder; scaled down proportionally to fit the section's printable width and height, with room for paragraph spacing and one caption line (longer captions may continue on the next page)
• Horizontal rules (---)
• Headers/footers: title in the top, page number in the bottom
• Core properties: author and title (via --author / --title)

If an image is not found — a red text placeholder is inserted.

Output example

Created: output.docx (45231 bytes, 42 blocks)