markdown-to-google-docslisted
Install: claude install-skill zhuy9/markdown-to-google-docs
# Markdown to Google Docs
Run the deterministic converter; do not reconstruct its formatting requests or
calculate Google Docs indexes by hand. Resolve input paths before invoking it.
## Run conversion
Requires Python 3.10+. From a repository checkout, install `python -m pip install .`.
For an extracted skill ZIP, install `python -m pip install -r scripts/requirements.txt`
relative to this skill directory. Run:
```bash
python <skill-directory>/scripts/convert.py input.md -o output/document.docx
```
Mermaid requires the official CLI: run `npm install -g @mermaid-js/mermaid-cli@11.17.0`
or `npm ci` in the source repository. Rendering is local and needs no key.
Diagrams render at `--mermaid-scale 3` by default. The renderer caps display
width, so a higher scale (maximum 5) only sharpens print output. Raise it when
the user reports soft or blurry diagrams; larger scales cost render time.
Images resolve against the Markdown file's directory. HTTP(S) downloads require
`--allow-remote-images`; use only when fetching those references is authorized.
Use `--dry-run` to inspect counts, warnings, local assets, and dependencies without
writing files, rendering diagrams, downloading images, or authenticating.
Mermaid syntax and output fidelity remain unchecked in this mode. Use `--strict`
when degradation must fail the conversion; any warning prevents upload and exits 1.
## Choose the delivery path
- Prefer a connected Google Docs MCP when its actual tools support creation,
forma