Markdown to Google Doc

---

name: md-to-gdoc

version: 1.0.1

description: Convert markdown files to properly formatted Google Docs. Use when asked to create a Google Doc from markdown, upload markdown to Google Docs, put a .md file into Google Docs, or convert research/notes/documents to Google Docs format.

---

# Markdown to Google Doc

Convert `.md` files into Google Docs with proper heading styles, bold, code blocks, lists, links, and blockquotes.

Requirements

Quick Start

scripts/md-to-gdoc.sh <file.md> [--title "Title"] [--parent <folder-id>] [--account <email>]

Resolve `scripts/` relative to this skill's directory.

Critical Rules

1. **Use `gog docs update --format=markdown`** — never `write --markdown`, never `create --file`. The `update` path is the only one that correctly applies Google Docs heading styles via the API.

2. **Markdown must have proper `#` headings.** If the source has "heading-looking" plain text without `#` markers, add them before conversion. The script warns but proceeds.

3. **Two-step process**: create empty doc → populate with `update`. This is deterministic and reliable.

4. **Always verify heading syntax** in the markdown before running. No `#` = no formatted headings in the output.

What Works

Known Limitations

Options

Troubleshooting