gdoc-to-markdown

Download Google Docs as markdown files with YAML frontmatter.

8|13|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/queen-of-code/AI-DLC --skill gdoc-to-markdown
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gdoc-to-markdown
Source: https://github.com/queen-of-code/AI-DLC/tree/main/plugins/ai-dlc-skills/skills/gdoc-to-markdown
Command: npx skills add https://github.com/queen-of-code/AI-DLC --skill gdoc-to-markdown

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gcloud, curl, and includes scripts (resource) components.

What problem does it solve?

Converts Google Docs into markdown files stored in a local knowledge repository to simplify archival, search, and reuse of documentation across projects.

Core Features & Use Cases

  • Export Google Docs to markdown with YAML frontmatter containing source URL, doc ID, owner, and category.
  • Fetch document metadata (title, owners) via Drive API and embed it in the saved file.
  • Use Case: Archive meeting notes or import Google Docs content into a personal external-brain folder for offline editing and versioned documentation.

Quick Start

Run the download-gdoc script with the Google Doc URL to save the document as a markdown file in your external-brain directory.

Frequently Asked Questions about gdoc-to-markdown

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I save a Google Doc as a local markdown file?

To save a Google Doc as a local markdown file, provide the document URL to the download script. It exports the content, slugifies the title, and writes the file to your specified output directory.

Do I need gcloud authentication to export Google Docs to markdown?

Yes, gcloud authentication is required to export Google Docs to markdown. The script uses gcloud credentials to perform Drive API metadata retrieval and curl to download the document content securely.

Can I import Google Docs into an external-brain knowledge repository?

Yes, you can import Google Docs into an external-brain repository. The script saves downloaded markdown files locally and attaches YAML frontmatter containing the source URL, doc ID, owner, and category for organization.

What metadata is included when converting Google Docs to markdown?

When converting Google Docs to markdown, the script fetches document metadata like title and owners via the Drive API. It embeds this information as YAML frontmatter at the top of the saved markdown file.

What is the best way to archive Google Docs for offline editing?

The best way to archive Google Docs for offline editing is exporting them as local markdown files. This simplifies archival and search by storing documentation with embedded metadata in a local knowledge repository.

Does converting Google Docs to markdown preserve document titles?

Yes, converting Google Docs to markdown preserves document titles by slugifying them to create a clean filename. The original title and other metadata are also stored inside the file's YAML frontmatter.