Hung-Yi’s Notes

Obsidian to Google Docs via Markdown

2 min read

Context

My primary writing environment is Obsidian, where notes live as plain markdown. The problem: when I need to share substantial work with someone who isn’t technically inclined — no vault access, no familiarity with .md files — I need a quick path to a collaboratable format. Google Docs fits that role well, but copy-pasting raw markdown produces garbage formatting.

The secondary motivation is LLM compatibility. Markdown is far easier to work with in LLMs than a Google Doc; staying in Obsidian as the source of truth keeps that door open. Google Docs becomes the presentation/collaboration layer, not the authoring layer.

Requirements

  • A Google Doc (new or existing)
  • Markdown content from Obsidian (or any markdown source)

Setup

Enable Markdown in Google Docs

This is a one-time setting per account:

  1. Open any Google Doc
  2. Go to Tools → Preferences
  3. Check Enable Markdown

This unlocks the "Paste from Markdown" option in the right-click context menu, which is the key mechanic for this whole workflow.

Use a Pageless Layout

For notes with wide tables, pageless layout prevents columns from getting squished inside the default page margins:

  1. Go to Format → Page setup
  2. Select Pageless
  3. Click OK

This is especially important for Obsidian notes that include multi-column tables — pageless lets them breathe.

Usage

Initial Paste

  1. Select all content in your Obsidian note (Ctrl+A)
  2. Copy (Ctrl+C)
  3. In the Google Doc, select all existing content (Ctrl+A) and delete it
  4. Clear all formatting: Format → Clear formatting (Ctrl+\)
  5. Right-click → Paste from Markdown

Steps 3 and 4 matter. Residual formatting or styles in the document can interfere with how the markdown paste renders. Starting clean produces the best result.

Syncing Updates

When the Obsidian note evolves and you need to push changes to Google Docs:

  1. Copy the full updated content from Obsidian
  2. In the Google Doc: Ctrl+A → Delete → Format → Clear formatting
  3. Right-click → Paste from Markdown

The whole document is replaced each time. This is intentional — it’s simpler and more reliable than trying to diff and patch.

Any edits made directly in Google Docs will be overwritten on the next sync. Treat the Google Doc as read-mostly for collaborators and write-never for yourself. All substantive work stays in Obsidian.

Graph View

Backlinks