docs-convert-gdoc-md

分类: 文档与知识管理 | 上传者: redhat-documentation | 下载: 0 | 版本: v1.0（最新）

Read a Google Docs document, Google Slides presentation, or Google Sheets spreadsheet and output as Markdown or CSV. Use this skill when asked to read, fetch, import, or convert a Google Doc, Google Slides, or Google Sheets URL.

更新日志: Source: GitHub https://github.com/redhat-documentation/redhat-docs-agent-tools

目录结构

当前层级: plugins/docs-tools/skills/docs-convert-gdoc-md/

📁 scripts/
- 📄 gdoc2md.py 10.2 KB
📄 SKILL.md 2.0 KB

SKILL.md

---
name: docs-convert-gdoc-md
description: Read a Google Docs document, Google Slides presentation, or Google Sheets spreadsheet and output as Markdown or CSV. Use this skill when asked to read, fetch, import, or convert a Google Doc, Google Slides, or Google Sheets URL.
model: claude-haiku-4-5@20251001
allowed-tools: Bash, Read, Write
---

# Convert Google Docs, Slides, or Sheets

Export Google content using the `gcloud` CLI for authentication:

- **Google Docs** → Markdown (`.md`)
- **Google Slides** → Markdown (`.md`) via PPTX with slide titles, bullet points, tables, and speaker notes
- **Google Sheets** → CSV (`.csv`)

## Prerequisites

- The [Red Hat Docs Agent Tools marketplace](https://redhat-documentation.github.io/redhat-docs-agent-tools/install/) is configured
- `gcloud` CLI is installed
- User is authenticated via `gcloud auth login --enable-gdrive-access`
- `python-pptx` is installed for Slides export (`python3 -m pip install python-pptx`)

## Instructions

1. The user provides a Google Docs, Slides, or Sheets URL.
2. Run the conversion script with the URL as the argument.
3. Read the output file and present the content to the user.

### Run the script

The script is at `plugins/docs-tools/skills/docs-convert-gdoc-md/scripts/gdoc2md.py`.

Always quote the URL and output file arguments:

```bash
python3 plugins/docs-tools/skills/docs-convert-gdoc-md/scripts/gdoc2md.py "<url>" ["<output_file>"]
```

- The script auto-detects the URL type:
  - `/document/d/` → Google Docs → Markdown
  - `/presentation/d/` → Google Slides → Markdown (via PPTX)
  - `/spreadsheets/d/` → Google Sheets → CSV
- If no output file is specified, it defaults to `<id>.md` or `<id>.csv`.

### Error handling

- **401**: Authentication expired. Tell the user to run `gcloud auth login --enable-gdrive-access`.
- **403**: No permission. The user needs access to the document.
- **404**: Wrong URL or the document doesn't exist.
- **ImportError**: `python-pptx` not installed. Tell the user to run `python3 -m pip install python-pptx`.

登录后下载/点赞/收藏 ❤ 4 | ★ 0

docs-convert-gdoc-md

目录结构

SKILL.md

举报内容

提示