md2docs

Convert Markdown files to Google Docs via the Google Drive API.

6|2|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/v1-io/v1tamins --skill md2docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: md2docs
Source: https://github.com/v1-io/v1tamins/tree/main/claude/skills/md2docs
Command: npx skills add https://github.com/v1-io/v1tamins --skill md2docs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires markdown, google-auth, google-auth-oauthlib, google-api-python-client, and includes scripts (resource) components.

What problem does it solve?

Markdown notes and documentation often remain static and hard to share in a polished, collaborative format. This skill automates turning Markdown into a fully formatted Google Doc, preserving structure and readability.

Core Features & Use Cases

  • One-command conversion: Turn a Markdown file into a Google Doc with a single command.
  • Format preservation: Retains headings, bold/italic, inline code, code blocks, tables, lists, links, and mermaid diagrams.
  • Workflow integration: Creates a Google Doc in your Drive and can optionally open it in your browser for immediate editing.

Quick Start

Run the md2docs command on a Markdown file to generate and open a Google Doc.

Frequently Asked Questions about md2docs

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

FAQPage Schema
How do I convert Markdown files into Google Docs?

Convert Markdown to Google Docs by rendering the content to HTML and uploading it through the Google Drive API. This automated process preserves headings, lists, tables, code blocks, links, and mermaid diagrams in a shareable document.

Does converting Markdown to Google Docs preserve mermaid diagrams?

Yes, converting Markdown to Google Docs preserves mermaid diagrams by utilizing optional mermaid rendering tools like mmdc or mermaid-cli. The skill processes these diagrams during the HTML rendering phase before uploading them to Google Drive.

What do I need to automate uploading Markdown to Google Drive?

To automate uploading Markdown to Google Drive, you need Google Drive API access and OAuth authentication via local browser prompts. The environment also requires the markdown and google-api-python-client libraries to handle rendering and upload.

What is the best way to share Markdown documentation for collaboration?

The best way to share Markdown documentation for collaboration is converting it into an editable Google Doc. This approach retains formatting like bold, italic, and inline code while enabling real-time collaboration through Google Drive.

Why does uploading Markdown to Google Docs require OAuth browser prompts?

Uploading Markdown to Google Docs requires OAuth browser prompts to securely authenticate your Google Drive API access. This local authentication step ensures the script has authorized permission to create and manage documents in your Drive.

Can I automatically open the generated Google Doc after conversion?

Yes, you can automatically open the generated Google Doc after conversion. The workflow creates the document in your Drive and can optionally open it directly in your browser for immediate editing and review.