Google DocsをMarkdownに書き出す方法

多くのチームが文章を書く場所はGoogle Docsです。ところが、その中身を静的サイトジェネレーターやLLMのプロンプト、Obsidianの保管庫、Markdown前提のCMSに持っていこうとした瞬間、いつも同じ壁に当たります。DocsはきれいにMarkdownを書き出してくれないのです。

この記事では、いちばん速い方法(ワンクリック)からいちばん細かく制御できる方法(APIをスクリプトで叩く)まで一通り取り上げ、それぞれの癖も押さえます。

なぜGoogle DocsをMarkdownにするのか

チームがDocsから中身を持ち出す、よくある理由です。

  • AIのワークフローに渡すため — ClaudeやChatGPT、GeminiにドキュメントのきれいなコンテキストをLLMを惑わせる装飾なしで渡せます
  • 静的サイトに公開するため — 現代的なサイトジェネレーター(Astro、Hugo、MkDocs、Docusaurus、Jekyll)はたいていMarkdownを前提にしています
  • 個人のナレッジベースを作るため — Obsidian、Logseq、Foamはいずれもノートを.mdファイルとして保存します
  • エディタから抜け出すため — Googleのリビジョン履歴に頼らず、自分の文章をGitでバージョン管理できます
  • アーカイブとバックアップのため — Markdownはプレーンテキストで、持ち運びやすく、Google Workspaceのアカウントが切れても人質に取られません

方法1:Minibase Chrome拡張機能(ワンクリック)

Minibase は、ドキュメント1件ずつならいちばん速い道です。拡張機能を入れ、ドキュメントを開き、アイコンをクリックすれば .md ファイルが手に入ります。

Minibaseが取り込むもの:

  • ドキュメントのタイトルと本文、見出し階層はそのまま(H1〜H6が ####### に対応)
  • 箇条書きと番号付きリスト(入れ子も含む)
  • 表を正しいMarkdownのテーブルとして
  • 挿入画像をMarkdownの画像参照として
  • インラインコメントを、投稿者とタイムスタンプ付きで元の位置に紐づけたまま
  • 太字、斜体、下線(下線は強調に変換)、取り消し線
  • 等幅フォントから判定したコードブロック

Minibaseが取り除くもの:

  • Google DocsのUI要素(ツールバー、ルーラー、検索パネル)
  • 共同編集者の在席インジケーターとアバター
  • 変更履歴のUI

光る場面: 単発のドキュメント、素早い書き出し、閲覧のみの権限で共有されたコンテンツの扱い。無料で保存は無制限、Minibase Plus(月5.99ドル)でAIテンプレート、履歴の保存、動画の文字起こしが使えます。

方法2:Docs公式の「Markdownとしてダウンロード」

Google Docsは2024年後半にMarkdownの書き出しを標準搭載しました。File → Download → Markdown (.md) から使えます。

長所: 無料、公式、拡張機能なしで完結。

短所: いくつか取りこぼします。

  • コメントは書き出しに含まれません
  • 複雑な表では列幅や配置が失われることがあります
  • 提案モードの編集は何も言わずに反映されます
  • 画像の参照先が認証の要るGoogleホストのURLになります(自前のサイトには不向き)

光る場面: コメントが要らず、画像を貼り直す手間を許せる、一回きりの書き出し。

方法3:Docs-to-Markdown(Google Apps Script)

まとまった量の書き出しや、既存の自動化パイプラインへの組み込みなら、Ed Bacher氏の Docs to Markdown が定番のオープンソース候補です。Docsの中で動くGoogle Apps Scriptで、MarkdownとHTMLを出力します。

セットアップ: 10分ほど。Extensions → Apps Script にスクリプトを貼り、権限を承認し、サイドバーから実行します。

長所: 無料、スクリプト化でき、たいていの複雑なドキュメントを処理でき、コメントも保持します。

短所: Apps Scriptの権限が必要、UIは古め、入れ子の表でうまくいかないケースがあります。

光る場面: Chrome拡張機能を入れられない環境(制限の厳しい社給ノートPC)での、繰り返しの書き出し。

方法4:Google Docs API+自作パイプライン

完全にプログラムで制御したいなら、Google Docs API がドキュメント構造をまるごとJSONで公開しています。手順はこうです。

  1. OAuth 2.0またはサービスアカウントで認証する
  2. documents.get を呼んでドキュメント構造を取得する
  3. body.content のツリーをたどってMarkdownを出力する

google-docs-to-markdown(TypeScript)のようなライブラリが、そのツリー走査を肩代わりしてくれます。

長所: 完全な制御、一括書き出し、CIパイプラインへの組み込み。

短所: 認証の準備(OAuthかサービスアカウント)、レート制限、開発者が必要。

光る場面: 100件以上のドキュメントを定期的に書き出す、社内ツールを作る、Workspace全体を静的サイトへ移行する。

4つの方法を比べる

方法速さコスト画像コメント
Minibase拡張機能⚡ 即座無料 → 月5.99ドル✅ リンク✅ インライン✅ きれい
Markdownとしてダウンロード速い無料⚠️ Googleホスト⚠️ 崩れがち
Docs-to-Markdownスクリプト中くらい無料
Google Docs API準備が重い開発工数場合による場合による場合による

AIが求めるもの

最終的にドキュメントの中身をLLMに渡すつもりなら、特に気を配る価値のある抽出がいくつかあります。

  • 見出し階層を残す。 RAGでは、LLMが ##### の構造を手がかりに該当箇所を探します。
  • 表はMarkdownのテーブルのまま残す。 パイプ区切りの表は、散文に変換されたものよりずっと効率よくトークン化されます。
  • 変更履歴とレビューのスレッドは落とす。 コンテキストウィンドウを膨らませるだけのノイズです。
  • コメントは元の位置に紐づけたまま残す。 いちばん重要な決定がそこに書かれていることがよくあります。

Minibaseの抽出はまさにこの用途に合わせて調整されています。自分のノートを毎日ClaudeやChatGPTに渡している研究者、プロダクトマネージャー、開発者が使っています。

多くのチームにとって最速の手順

1〜10件のドキュメントを、いますぐきれいなMarkdownにしたいなら:

  1. Minibase for Chrome をインストールする
  2. ドキュメントを開く
  3. Minibaseをクリックする
  4. 完了 — その .md をObsidian、Notion、自分のリポジトリ、あるいはClaudeにドラッグ

数百件を定期的に書き出すなら、Google Docs APIを既存のパイプラインに組み込みましょう。

どちらの道を選んでも、あなたはコンテンツを自分の手に取り戻せます。しかも、どのツールでも読める形式で。


MinibaseはどんなウェブページもワンクリックできれいなMarkdownに変換し、AIが検索できるローカル保管庫へ直接保存します。拡張機能は保存無制限で無料。Minibase Plus(月5.99ドル/年34.99ドル)でAIテンプレート、履歴、動画の文字起こしが加わります。minibase.md

Continue reading

よりスマートに保存しませんか?

あらゆるウェブページをワンクリックでMarkdownに変換。

Chromeに追加