Googleドキュメントから効率的にMarkdown作成【Docs to Markdown】

2019年6月11日　作成

　音声入力による文字起こしは、現状 Google ドキュメントが最も使いやすいと思います。認識精度が高く応答が早く、音声入力中にキーボード入力ができるためです。

　そこで Google ドキュメントを中心として記事の元データを作成・管理し、Markdown化して記事にすれば効率的です。Google ドキュメントから直接マークダウンへ変換できるアドオン「**Docs to Markdown**」で実現できます。


# Docs to Markdownについて


## インストール

[ここからインストール](https://gsuite.google.com/marketplace/app/docs_to_markdown/700168918607)してください。


## 使い方



1. アドオン　＞　Docs to Markdown　＞　Convert
    1. ![image3.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/186338/b0463cd2-ace8-a119-4f8f-b0b0b2f35398.png)

2. 右パネルの「Markdown」ボタンを選択
    2. ![image1.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/186338/bb5df3f7-01a3-b244-26a3-dad941c3efd0.png)

3. Markdownテキストが表示されるので、コピペして使用
    3. **ただし、後述のように「gd2md-html」とある箇所を画像で差し替えること**
    4. テキスト先頭から数十行は変換ログや使い方がコメント内に書かれている。本文は後ろのほうにちゃんとあるのでご安心を。
    5. ![image7.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/186338/8e476e3c-d9c7-ef4f-0408-0ac573abe05b.png)

## 変換できるもの

以下のものはちゃんと変換できることを確認しました。



*   見出し
*   リンク
*   表
*   箇条書き
*   コードブロック

画像については、Markdown（プレーンテキスト）とは別に保存されるものなので、うまく変換できなくても仕方ないのかな、と思います。

画像があった個所には↓のような文字が出力されているので、該当箇所を「gd2md-html」で検索して探し出し、メディアに合わせた方法で画像が表示されるようにします。

```
>>>>> gd2md-html alert: inline image link here (to images/-0.png). Store image on your image server and adjust path/filename if necessary. 
(Back to top)(Next alert)
>>>>>
```

GoogleドキュメントからQiitaへ直接画像をコピペすることはできないようです。Googleドキュメントをzip形式でダウンロード・解凍してから、QiitaのMarkdown入力欄へ画像ファイルをドラッグ&ドロップするとよいと思います。

## コードブロックの書き方

以下のものはコードブロックとして解釈される



*   普通のマークダウンの書き方（文字を「`」で囲む or 上下行を「```」で囲む）
*   １セルのみの表

例）Googleドキュメントで以下の３通りの書き方をした場合

![image10.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/186338/10985e61-e5d8-e419-f601-cd272fe5a587.png)


以下のようなテキストが出力される。

![image6.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/186338/1afbc183-1c0b-74a7-eaf9-d4bc1cb3b19d.png)

Markdownエディタでこんな感じで表示される。
![image4.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/186338/e3865f20-4e06-1f5b-314a-6962545a24ac.png)

参考　[https://github.com/evbacher/gd2md-html/blob/ab31c3b66103895cb4c9188501ca8d9f61d85a15/md-verify.md#code-blocks](https://github.com/evbacher/gd2md-html/blob/ab31c3b66103895cb4c9188501ca8d9f61d85a15/md-verify.md#code-blocks)


## ソースコードについて

Docs to Markdownのコード「gd2md-html」は[GitHubで公開](https://github.com/evbacher/gd2md-html)されています。

[バグ報告はこちらだそうです。](https://github.com/evbacher/gd2md-html/issues)


# おまけ１：Google ドキュメントについて


## よく使うショートカット



*   ショートカット一覧を表示
    *   Ctrl+/（スラッシュ）
*   音声入力をON/OFF
    *   Ctrl+Shift+S
*   見出し１～５ 
    *   Ctrl+Alt+１～５ 
*   見出しを解除（段落スタイルを「標準テキスト」にする）
    *   Ctrl+Alt+０
*   箇条書き
    *   Ctrl+Shift+８
*   番号つきリスト
    *   Ctrl+Shift+７
*   書式なし貼り付け
    *   Ctrl+Shift+V
*   書式クリア
    *   Ctrl+\（バックスラッシュ）


## 「ドキュメントの概要」が便利

画面左上のアイコンをクリックすると、見出し化した行が一覧できます。

![image8.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/186338/c2cc7b02-912b-ffd6-6287-ae5fc245b0f8.png)



# おまけ２：ローカルでのMarkdown生成方法

pandocをPCにインストールすればdocxファイルをMarkdownに変換できます。

<span style="text-decoration:underline;">参考：[https://qiita.com/kinagaki/items/460577f46529484d720e](https://qiita.com/kinagaki/items/460577f46529484d720e)</span>

Googleドキュメントの変換なら以下のような作業の流れ。



1. Googleドキュメントからdocx形式でダウンロード
2. pandocでMarkdownに変換


![image9.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/186338/9fe24e11-67e7-486d-0779-13c695ff61c6.png)


Dockerイメージもあります。

Docker Hub：[https://hub.docker.com/r/pandoc/core](https://hub.docker.com/r/pandoc/core)

```
docker pull pandoc/core
```


<!-- Docs to Markdown version 1.0β17 -->