Search

PythonReactSEOPDF
OpenClaw

md-to-gdoc

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.

brennerspear0 source installs☆ 0 Repository starsv1.0.1

Installation

Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.

SkillHub CLI

skillhub install brennerspear/md-to-gdoc

Inspect the source and compatibility requirements, then follow its installation steps.

Give your agent the source link and ask it to inspect instructions and dependencies before explaining the installation steps.

View source ↗Guides

Skill instructions

Markdown to Google Doc

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

Requirements

  • gog — Google Workspace CLI (must be authenticated: gog auth add <email>)
  • python3 — used for JSON parsing in the script

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

  • #–###### headings → Google Docs Heading 1–6
  • **bold** → bold text
  • `inline code` → Courier New
  • Fenced code blocks → Courier New + gray background
  • > blockquotes → indented paragraphs
  • - bullets → bullet-prefixed text
  • 1. numbered → number-prefixed text
  • [text](url) → hyperlinks
  • Markdown tables → native Google Docs tables

Known Limitations

  • *italic* may not render (gog CLI bug in inline formatting parser — italic detection fails in certain contexts)
  • Bullet/numbered lists use text prefixes (•, 1.), not native Google Docs list objects
  • Horizontal rules render as 40 dashes

Options

  • --title — Doc title. Defaults to filename with hyphens→spaces.
  • --parent — Google Drive folder ID to place the doc in.
  • --account — Google account email. Defaults to gog's default (first authenticated account).

Troubleshoot...

Source information

Source
github
Repository
openclaw/skills
Path
skills/brennerspear/md-to-gdoc
Version
1.0.1
Commit
dd24c75a656af53c639336b4ba128c15b71d70fd
Classification source
rules
Status
active
Visibility
public

These signals come from indexed source analysis and may lag behind changes. Check the current source files.

Extracted content

SKILL.md
# Markdown to Google Doc

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

## Requirements

- **[gog](https://github.com/tychohq/gog)** — Google Workspace CLI (must be authenticated: `gog auth add <email>`)
- **python3** — used for JSON parsing in the script

## Quick Start

```bash
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

- `#`–`######` headings → Google Docs Heading 1–6
- `**bold**` → bold text
- `` `inline code` `` → Courier New
- Fenced code blocks → Courier New + gray background
- `> blockquotes` → indented paragraphs
- `- bullets` → bullet-prefixed text
- `1. numbered` → number-prefixed text
- `[text](url)` → hyperlinks
- Markdown tables → native Google Docs tables

## Known Limitations

- `*italic*` may not render (gog CLI bug in inline formatting parser — italic detection fails in certain contexts)
- Bullet/numbered lists use text prefixes (`•`, `1.`), not native Google Docs list objects
- Horizontal rules render as 40 dashes

## Options

- `--title` — Doc title. Defaults to filename with hyphens→spaces.
- `--parent` — Google Drive folder ID to place the doc in.
- `--account` — Google account email. Defaults to gog's default (first authenticated account).

## Troubleshoot...

Related skills

OpenClaw

bambu-studio-ai

heyixuan2

Bambu Lab 3D printer control and automation. Activate when user mentions: printer status, 3D printing, slice, analyze model, generate 3D, AMS filament, print monitor, Bambu Lab, or any 3D printing task. Full pi...

OpenClaw

dojo.md

edholofy

University for AI agents. 92 courses, 4400+ scenarios, any model via OpenRouter. Auto-training loops generate per-model SKILL.md documents. Works with Claude Code, OpenClaw, Cursor, Windsurf. No fine-tuning req...

OpenClaw

geo-optimization

capt-marbles

Generative Engine Optimization (GEO) for AI search visibility. Optimize content to appear in ChatGPT, Perplexity, Claude, and Google AI Overviews. Use when optimizing websites, pages, or content for LLM discove...