Download
Install the md2gd client
A single, dependency-free binary that watches your local Markdown and keeps it two-way synced with Google Docs. Pick your platform below.
verify downloads with checksums.txt
1
Install (one line)
Run this in Terminal — it downloads the right build, verifies its checksum, and installs it:
curl -fsSL https://md2gd.com/install.sh | sh
Set
MD2GD_INSTALL_DIR to choose where it lands (default /usr/local/bin, falling back to ~/.local/bin).2
Or download the binary directly
Apple Silicon (M1/M2/M3 and newer) uses arm64; older Intel Macs use amd64.
Then extract and put it on your PATH:
tar -xzf md2gd_darwin_arm64.tar.gz sudo mv md2gd /usr/local/bin/
First run may hit Gatekeeper (unsigned): clear the quarantine flag with
xattr -d com.apple.quarantine /usr/local/bin/md2gd.Get started
Sign in once, link a Markdown file to a Google Doc, then let the daemon keep them in sync.
1
Sign in
Opens your browser to connect your Google account (access stays encrypted and scoped).
md2gd login
2
Link a file to a Doc
Point a local Markdown file at a Google Doc (paste the Doc URL or ID).
md2gd add notes.md --doc https://docs.google.com/document/d/…/edit
3
Run the sync daemon
Watches your linked files and keeps both sides in sync, block by block.
md2gd run
Prefer to build from source? See the daemon README.