How do I install the Md2docs skill?

Run npx skillmds@latest add tomevault-io/md2docs in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Md2docs safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Md2docs?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Md2docs free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Md2docs?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Md2docs by tomevault-io — Agent Skill

Name: Md2docs
Author: tomevault-io

Md2docs

Convert a Markdown file into a nicely formatted Google Doc and open it in the browser. Use when the user wants to create a Google Doc from a .md file, share markdown content as a Google Doc, or invoke /md2docs. Handles headings, bold, italic, inline code, fenced code blocks, tables, lists, links, horizontal rules, and mermaid diagrams. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

md2docs

Convert a Markdown file to a formatted Google Doc with one command.

Usage

/md2docs <path-to-file.md>

Optional arguments after the file path:

--title "Custom Title" to override the doc title (default: filename as title case)
--no-open to skip opening the browser

Workflow

Read the markdown file specified by the user
Run the conversion script:

python3 SKILL_DIR/scripts/md2docs.py <file_path> [--title "Title"] [--no-open]

Replace SKILL_DIR with the absolute path to this skill's directory (the directory containing this SKILL.md file).

Report the Google Doc URL back to the user

First-Time Setup

If the script reports "No client_secret.json found", guide the user through setup:

Go to Google Cloud Console
Create a project (or use existing)
Enable the Google Drive API
Go to APIs & Services > Credentials
Create an OAuth 2.0 Client ID (application type: Desktop app)
Download the JSON file
Save it to ~/.md2docs/client_secret.json

The first run opens a browser for OAuth consent. After that, the token is cached at ~/.md2docs/token.json and no browser auth is needed until the token expires.

Each developer authenticates with their own Google account. Docs are created in their personal Google Drive.

What Gets Formatted

H1-H6 headings with native Google Docs heading styles
Bold, italic, bold+italic
inline code with Courier New font and gray background
Fenced code blocks with Courier New font, gray background, and border
Tables with bordered cells and header row styling
Unordered and ordered lists with proper nesting
Links as clickable hyperlinks
Horizontal rules
Mermaid diagrams rendered as embedded images (requires mmdc or npx)

Environment Variables

MD2DOCS_CLIENT_SECRET - override path to client_secret.json (default: ~/.md2docs/client_secret.json)

Dependencies

The script auto-installs these pip packages on first run if missing:

markdown
google-auth
google-auth-oauthlib
google-api-python-client

Optional for mermaid diagram rendering:

mmdc (mermaid CLI) or npx (will use @mermaid-js/mermaid-cli)

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: md2docsdescription: Convert a Markdown file into a nicely formatted Google Doc and open it in the browser. Use when the user wants to create a Google Doc from a .md file, share markdown content as a Google Doc, or invoke /md2docs. Handles headings, bold, italic, inline code, fenced code blocks, tables, lists, links, horizontal rules, and mermaid diagrams. Use when this capability is needed.---# md2docsConvert a Markdown file to a formatted Google Doc with one command.## Usage```/md2docs <path-to-file.md>```Optional arguments after the file path:- `--title "Custom Title"` to override the doc title (default: filename as title case)- `--no-open` to skip opening the browser## Workflow1. Read the markdown file specified by the user2. Run the conversion script:```bashpython3 SKILL_DIR/scripts/md2docs.py <file_path> [--title "Title"] [--no-open]```Replace `SKILL_DIR` with the absolute path to this skill's directory (the directory containing this SKILL.md file).3. Report the Google Doc URL back to the user## First-Time SetupIf the script reports "No client_secret.json found", guide the user through setup:1. Go to [Google Cloud Console](https://console.cloud.google.com/)2. Create a project (or use existing)3. Enable the **Google Drive API**4. Go to **APIs & Services > Credentials**5. Create an **OAuth 2.0 Client ID** (application type: **Desktop app**)6. Download the JSON file7. Save it to `~/.md2docs/client_secret.json`The first run opens a browser for OAuth consent. After that, the token is cached at `~/.md2docs/token.json` and no browser auth is needed until the token expires.Each developer authenticates with their own Google account. Docs are created in their personal Google Drive.## What Gets Formatted- H1-H6 headings with native Google Docs heading styles- **Bold**, *italic*, ***bold+italic***- `inline code` with Courier New font and gray background- Fenced code blocks with Courier New font, gray background, and border- Tables with bordered cells and header row styling- Unordered and ordered lists with proper nesting- [Links](https://example.com) as clickable hyperlinks- Horizontal rules- Mermaid diagrams rendered as embedded images (requires `mmdc` or `npx`)## Environment Variables- `MD2DOCS_CLIENT_SECRET` - override path to client_secret.json (default: `~/.md2docs/client_secret.json`)## DependenciesThe script auto-installs these pip packages on first run if missing:- `markdown`- `google-auth`- `google-auth-oauthlib`- `google-api-python-client`Optional for mermaid diagram rendering:- `mmdc` (mermaid CLI) or `npx` (will use `@mermaid-js/mermaid-cli`)---> Converted and distributed by [TomeVault](https://tomevault.io/claim/v1-io) — claim your Tome and manage your conversions.

Frequently asked questions