【Googleドキュメント】GitHub README(.md)からDocs作成!Markdown一括取込

GitHubのリポジトリ内にあるREADME.mdファイルを、Googleドキュメントに移行したいとお考えではありませんか。Markdown形式のままでは共同編集やコメント機能を十分に活用できません。この記事では、複数の.mdファイルを一括でGoogle Docsに変換・取り込む方法を2つご紹介します。いずれの方法も特別な知識がなくても実行できます。

なぜMarkdownからGoogle Docsへ変換するのか

GitHubのREADME.mdは軽量でバージョン管理に優れる反面、複数人での同時編集やコメント機能が弱いという欠点があります。Google Docsに変換すれば、提案モードでのレビュー、変更履歴の保持、アクセス権限の細かい設定が可能になります。また、社内ドキュメントとして整理する際にも、Docsの方がレイアウト調整やフォーマットが柔軟です。一括取り込みの需要は、複数リポジトリを管理しているチームや、GitHubからドキュメント管理基盤を移行する場面で特に高まります。

方法1:Google Apps Scriptで一括変換する手順

Google Apps Scriptを使えば、Googleドライブ内のMarkdownファイルを自動で検出し、Google Docsに変換できます。事前にドライブに.mdファイルをアップロードしておく必要があります。

ステップ1:スクリプトエディタを開く

1. Googleドライブにアクセスする
   変換したい.mdファイルを入れるフォルダを作成し、そこにファイルをアップロードします。
2. Apps Scriptプロジェクトを作成する
   「新規」→「その他」→「Google Apps Script」をクリックします。プロジェクト名は「MarkdownToDocs」などにします。

ステップ2:コードを記述する

1. スクリプトを記述する
   以下のコードをエディタに貼り付けます。コード内のFOLDER_IDは、.mdファイルを格納したフォルダのIDに置き換えてください。

function convertMarkdownToDocs() {
  var folderId = 'YOUR_FOLDER_ID'; // フォルダIDを指定
  var folder = DriveApp.getFolderById(folderId);
  var files = folder.getFilesByType(MimeType.PLAIN_TEXT);
  while (files.hasNext()) {
    var file = files.next();
    var name = file.getName().replace('.md', '');
    var content = file.getBlob().getDataAsString('UTF-8');
    var doc = DocumentApp.create(name + ' - converted');
    var body = doc.getBody();
    // Markdownをパースして段落・見出しに変換(簡易版)
    var lines = content.split('\n');
    for (var i = 0; i < lines.length; i++) {
      var line = lines[i];
      if (line.startsWith('# ')) {
        body.appendParagraph(line.substring(2)).setHeading(DocumentApp.ParagraphHeading.HEADING1);
      } else if (line.startsWith('## ')) {
        body.appendParagraph(line.substring(3)).setHeading(DocumentApp.ParagraphHeading.HEADING2);
      } else if (line.startsWith('### ')) {
        body.appendParagraph(line.substring(4)).setHeading(DocumentApp.ParagraphHeading.HEADING3);
      } else {
        body.appendParagraph(line);
      }
    }
  }
}

このコードは見出し(#、##、###)のみを認識します。リストやコードブロックはそのままテキストになります。

ステップ3:スクリプトを実行する

1. 権限を承認する
   初回実行時に「このアプリは確認されていません」と表示される場合があります。「詳細」→「安全ではないページに移動」をクリックし、スクリプトにドライブアクセスを許可します。
2. 関数を実行する
   エディタの「実行」ボタンをクリックすると、フォルダ内の.mdファイルが順次変換されます。
3. 変換結果を確認する
   変換されたドキュメントは同じフォルダに「元のファイル名 - converted」という名前で保存されます。

方法2:Chrome拡張機能「Markdown to Docs」を使う

コードを書かずに変換したい場合は、Chrome拡張機能を利用します。ただし、一括変換ではなく1ファイルずつの操作になります。

準備と使い方

1. 拡張機能をインストールする
   Chromeウェブストアで「Markdown to Docs」を検索し、追加します。
2. Markdownファイルを開く
   ブラウザ上で.mdファイルの内容を表示しているページ(例:GitHubのプレビュー)を開きます。
3. 拡張機能をクリックする
   ツールバーのアイコンをクリックすると、変換ダイアログが表示されます。「Convert」ボタンを押すと、新しいGoogle Docsが作成されます。

この方法はMarkdownのほとんどの構文(コードブロック、リスト、リンク)を正確に変換します。ただし、画像はURLのまま表示され、自動的に埋め込まれない場合があります。

変換時の注意点と失敗例

画像が表示されない

Markdown内の相対パス画像(例:./images/logo.png)は、Google Docsに変換してもリンク切れになります。事前に画像をGoogleドライブにアップロードし、絶対URLに書き換える必要があります。

テーブルのレイアウトが崩れる

Markdownのテーブルは、Apps Scriptの簡易変換では認識されません。アドオンを使った場合でも、列幅やセルの結合が保持されないことがあります。変換後に手動で調整してください。

コードブロックの書式が失われる

バッククォートで囲まれたコードブロックは、プレーンテキストとして変換されます。Google Docsの「コードブロック」書式を手動で適用する必要があります。

Apps Scriptとアドオンの比較

比較項目	Apps Script	Chrome拡張機能
一括処理	複数ファイルを自動で一括変換	1ファイルずつ手動操作
変換品質	基本的な見出しのみ(カスタマイズ可能)	リスト・コードブロックなど高精度
初期設定の手間	コードの記述とフォルダIDの指定が必要	拡張機能をインストールするだけ
画像対応	自動処理なし(コード修正で対応可能)	絶対URLなら埋め込み可能

まとめ

この記事では、GitHubのREADME.mdをGoogle Docsに一括取り込む2つの方法を解説しました。Apps Scriptを使えばフォルダ単位の自動変換が可能で、アドオンを使えば高品質な個別変換ができます。いずれの方法も、画像やテーブル、コードブロックの扱いに注意が必要です。まずは小さなファイルでテスト実行し、変換後の体裁を確認することをおすすめします。また、変換したDocsはそのまま共有や編集に活用できるため、チーム内のドキュメント整備に役立ててください。

📄

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