README file from
GithubGDocs
Plugin that opens Google Drive shortcut files in the editor tab. Particularly suited for those who store and sync their vault in Google Drive.
When Google Drive for Desktop (or similar sync) stores Docs, Sheets, and other Workspace files in your vault, they appear as small JSON files (.gdoc, .gsheet, etc.). GDocs registers those extensions, shows them in the file explorer with their extension, and displays the linked Google document in the same tab when you click them.
Repository: https://github.com/oilandrust/obsidian-gdocs
Requirements
- Obsidian 1.8+ (desktop for embedded browser)
- Google Drive shortcut files in your vault (from Drive for Desktop, rclone, Synology Drive, etc.)
Supported extensions
| Extension | Google app |
|---|---|
.gdoc |
Docs |
.gsheet |
Sheets |
.gslides |
Slides |
.gdraw |
Drawings |
.gform |
Forms |
.gtable |
Tables |
.gscript |
Apps Script |
.gjam |
Jamboard |
Usage
Click any .gdoc, .gsheet, or other supported shortcut in the file explorer. The plugin reads doc_id, url, or resource_id from the JSON shortcut and shows the document in the current tab.
- Normal click — opens in the active tab (like switching between notes).
- Cmd/Ctrl+click or middle-click — opens in a new tab (standard Obsidian behavior).
The document is rendered in an embedded browser inside the file tab. This is separate from the core Web Viewer plugin (no shared toolbar or login session).
Mobile
Embedded browser is not available on mobile. GDocs shows the URL with Copy link and Open in browser buttons.
Shortcut file format
Shortcut files are JSON. Google Drive for Desktop typically uses:
{
"doc_id": "1VxFROKm0zoJV2iH678wO94hZ0PY9fN_gAGOxhZacc8w",
"email": "[email protected]"
}
GDocs builds the Docs/Sheets URL from doc_id and the file extension (.gdoc, .gsheet, etc.).
Older or third-party sync tools may use:
{
"url": "https://docs.google.com/spreadsheets/d/…/edit",
"resource_id": "spreadsheet:…"
}
Troubleshooting
-
Files not visible in the explorer
Check Settings → Files & links → Detect all file extensions, and ensure.gdoc/.gsheetare not listed under Excluded files. -
Warning about moving shortcut files
Do not move.gdoc/.gsheetfiles out of a syncing Google Drive folder; Google may delete the online document.
License
MIT