【Googleドキュメント】Docs→Markdown変換!アドオンと手動の使い分け

Googleドキュメントで書いた文書をブログやドキュメントサイトに掲載するとき、Markdown形式で出力したいと考える方は多いでしょう。しかし、標準機能ではMarkdownに変換できず、どうすればよいか迷ってしまうこともあります。この記事では、アドオンを使う方法と手動で変換する方法の2つを紹介します。それぞれの特徴を理解して、自分に合った変換方法を選べるように解説していきます。

GoogleドキュメントからMarkdownに変換する2つの方法の概要

Googleドキュメントは文章の作成に優れていますが、Markdown形式でのエクスポート機能は標準では提供されていません。そのため、外部のアドオンを利用するか、手動で変換作業を行う必要があります。アドオンは自動変換が手軽な反面、変換ルールが固定されているため、意図しない書式になってしまうこともあります。一方、手動変換は時間がかかるものの、変換結果を完全にコントロールできます。ここでは、まずアドオンを使った方法と手動変換の基本を説明します。

アドオンを使った変換方法の手順

最初に紹介するのは、アドオン「Docs to Markdown」を利用する方法です。このアドオンはGoogle Workspace Marketplaceから無料でインストールでき、インストール後の操作も簡単です。

「Docs to Markdown」アドオンのインストール手順

1. 拡張機能メニューを開く
   Googleドキュメントのメニューバーから「拡張機能」をクリックし、「アドオン」→「アドオンを入手」を選択します。
2. アドオンを検索してインストール
   Google Workspace Marketplaceの検索窓に「Docs to Markdown」と入力します。表示されたアドオンを選び、「インストール」ボタンをクリックします。アカウントへのアクセス許可が求められたら「許可」を押します。
3. アドオンを起動する
   インストールが完了したら、再び「拡張機能」メニューを開き、「Docs to Markdown」→「Convert document to Markdown」を選択します。サイドバーが表示され、変換オプションが設定できるようになります。

アドオンで変換を実行する手順

1. 変換オプションを確認する
   サイドバーには「Include front matter」「Use GFM (GitHub Flavored Markdown)」「Wrap text at 80 characters」などのチェックボックスがあります。必要に応じて設定を変更します。
2. 変換を実行する
   「Convert」ボタンをクリックすると、ドキュメントの内容がMarkdownに変換され、サイドバー内にプレビューが表示されます。プレビューの下部にある「Copy to clipboard」ボタンで変換結果をコピーできます。
3. 変換結果を保存する
   コピーしたMarkdownを任意のテキストエディタやブログエディタにペーストして保存します。必要に応じて、ファイルとしてダウンロードすることも可能です。

このアドオンの利点は、見出し(# 見出し)、太字(**太字**)、斜体(*斜体*)、箇条書き(- 項目)、番号付きリスト(1. 項目)、リンク([テキスト](URL))、画像()、表など、主要な書式を自動で変換してくれることです。ただし、Googleドキュメント独自の書式(例えば、特定のフォントサイズや色)はMarkdownでは表現できないため、変換後に調整が必要な場合もあります。

手動変換の方法とそのメリット

アドオンを使わずに、手動で変換する方法もあります。この方法は、アドオンのインストールが不要で、Googleドキュメントの標準機能だけで完結できる点が魅力です。また、変換ルールを自分で適用するため、出力結果を細かく制御できます。

手動変換の基本的な手順

1. 文書をプレーンテキストにコピーする
   Googleドキュメントの全文を選択(Ctrl+A)し、コピー(Ctrl+C)します。テキストエディタ(メモ帳など)に貼り付け(Ctrl+V)ます。この時点で書式が失われるため、代わりにMarkdownの記法を手動で追加していきます。
2. 見出しを変換する
   文書内の見出しを確認し、レベルに応じて「#」を付加します。例えば、見出し1なら「# 見出し」、見出し2なら「## 見出し」、見出し3なら「### 見出し」と書き換えます。
3. 太字・斜体・箇条書きを変換する
   太字の部分は「**テキスト**」、斜体は「*テキスト*」、箇条書きは各行の先頭に「- 」または「* 」を追加します。番号付きリストは「1. 」「2. 」のように番号を振ります。
4. リンクと画像を変換する
   リンクは「[リンクテキスト](URL)」の形式に、画像は「」の形式に書き換えます。URLはGoogleドキュメント上のリンクからコピーして貼り付けます。
5. 表を変換する
   Googleドキュメントの表は、Markdownの表記法(パイプ区切り)に手動で変換します。各セルの内容を「| セル1 | セル2 |」のように並べ、見出し行の下に「| — | — |」の区切り行を追加します。

手動変換のメリットは、変換結果を完全に自分でコントロールできることです。特に、コードブロックや引用、注釈など、アドオンがうまく変換できない要素を正確に表現できます。ただし、文書が長くなると手間がかかるため、短い文書や変換頻度が低い場合に向いています。

アドオンと手動の比較表

項目	アドオン(Docs to Markdown)	手動変換
インストールの要否	必要(無料)	不要
変換速度	高速(数秒)	低速(手動入力)
書式の正確さ	基本的な書式は正確だが、複雑な書式は対応できない場合がある	完全に自分で制御できる
対応する書式	見出し、太字、斜体、箇条書き、リンク、画像、表、コードブロック(一部)	すべてのMarkdown記法に対応可能
大量文書への適性	非常に適している	不向き
変換後の微調整	ある程度必要	ほぼ不要(正確に書けば)

変換時の注意点とよくあるトラブル

アドオンが変換できない書式がある

「Docs to Markdown」アドオンは、Googleドキュメントのほとんどの書式を変換できますが、一部の書式には対応していません。例えば、テキストボックス内のテキスト、図形描画、数式、脚注、ヘッダー/フッターなどは変換されないか、無視されます。これらの要素を含む文書を変換する場合は、事前にプレーンテキストとしてコピーしてから手動でMarkdownに書き起こす必要があります。

リストのインデントが崩れる場合がある

Googleドキュメントでインデントを使って階層化されたリスト(例えば、サブリスト)は、アドオンで変換するとインデントが正しく反映されないことがあります。変換後にMarkdownのインデント(半角スペース4つ)を手動で調整してください。また、手動変換の場合は、子リストの前に4つの半角スペースを挿入することで正しい階層を表現できます。

表の変換に注意が必要

アドオンは表をMarkdownの表記法に変換しますが、セル内の改行や複雑な結合セルには対応していません。結合セルは別々のセルとして出力されるため、変換後に手動で修正する必要があります。手動変換の場合も、結合セルは表現できないため、事前に表の構造を単純化しておくことをおすすめします。

画像のエクスポート方法

アドオンは画像のリンクとして、Googleドキュメント内の画像の共有リンクを生成します。しかし、そのリンクは一時的なもので、共有設定によっては外部からアクセスできない場合があります。安定した画像表示のためには、画像を別途アップロードし、そのURLをMarkdownに埋め込むことを推奨します。手動変換の場合は、画像をダウンロードして適切な場所にアップロードし、そのURLをの形式で記述します。

まとめ

GoogleドキュメントからMarkdownに変換する方法として、アドオン「Docs to Markdown」を使う方法と手動で変換する方法を紹介しました。アドオンは大量の文書を短時間で変換したい場合に非常に便利です。一方、手動変換は自由度が高く、細かい調整が必要な文書や一度きりの変換に適しています。変換頻度や文書の複雑さに応じて、これらの方法を使い分けてください。また、変換後のMarkdownは、各プラットフォームの仕様に合わせて微調整すると、より見栄えの良いドキュメントに仕上がります。

📄

Googleドキュメントトラブル完全解決データベースこの記事以外にも、書式・共有・Apps Script・引用など様々な困りごとへの解決策をまとめています。逆引きに活用してください。