# Gdocs Markdown

> Create Google Docs from Markdown files. Use when the user wants to create a Google Doc from Markdown content, or when working with gog CLI and need to populate Google Docs with content. This skill handles the conversion Markdown → DOCX → Google Docs via Drive upload, since gog docs CLI only supports create/export/cat/copy but NOT write/update content.

- Skill: `demerzels-lab/gdocs-markdown` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add demerzels-lab/gdocs-markdown`
- Raw SKILL.md: https://api.skillmd.com/api/skills/demerzels-lab/gdocs-markdown/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: Demerzels-lab (https://skillmd.com/u/demerzels-lab)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/demerzels-lab/gdocs-markdown

---


# Google Docs from Markdown

Create Google Docs from Markdown files using the workflow: Markdown → DOCX → Drive Upload → Google Docs.

## Why This Skill Exists

`gog docs` CLI does NOT support writing/updating content to Google Docs. It only supports:
- `create` - Create empty doc
- `export` - Export to file
- `cat` - Read content
- `copy` - Copy existing doc

This skill provides the missing workflow to create Google Docs WITH content from Markdown.

## Author

Created by **techla**

## Prerequisites

- `gog` CLI authenticated with Google account
- `pandoc` binary (auto-downloaded on first use if not available)

## Installation Note

After installing from ClawHub, fix the script permissions:
```bash
chmod +x ~/.openclaw/workspace/skills/gdocs-markdown/scripts/gdocs-create.sh
```

## Usage

### Quick Create

```bash
# Create Google Doc from markdown file
gdocs-create.sh /path/to/file.md "Tiêu đề Document"
```

### Manual Workflow

If you need more control, follow these steps:

1. **Ensure pandoc is available:**
   ```bash
   # Auto-downloaded to /tmp/pandoc-3.1.11/bin/pandoc on first use
   # Or use system pandoc if available
   ```

2. **Convert Markdown to DOCX:**
   ```bash
   /tmp/pandoc-3.1.11/bin/pandoc input.md -o output.docx
   ```

3. **Upload to Drive (auto-converts to Google Docs):**
   ```bash
   gog drive upload output.docx
   ```

4. **Result:** Google Drive returns a link to the converted Google Doc

## Script Reference

See `scripts/gdocs-create.sh` for the helper script that automates this workflow.

## Example

```bash
# Create a report from markdown
echo "# Báo Cáo\n\nNội dung..." > /tmp/report.md
gdocs-create.sh /tmp/report.md "Báo Cáo Tháng 2"

# Output: https://docs.google.com/document/d/xxxxx/edit
```

## Notes

- Google Drive automatically converts DOCX to Google Docs format on upload
- The resulting document is fully editable in Google Docs
- Original DOCX file remains in Drive but can be deleted if only Google Docs version is needed