DOCXをMarkdownに変換
Wordで管理しているドキュメントをGitリポジトリへ移すには、まず各.docxをMarkdownに変換する必要があります。このツールは、#見出し、パイプ形式の表、画像リンクを含むCommonMark準拠のテキストを書き出すので、そのままコミットできます。
文書変換
またはPDF, DOC, DOCX … ファイルをここにドロップ ·
1ファイルあたり最大95 MB· 最大20ファイルまで· 30分後に削除
ファイルは当社のサーバーで処理され、30分後に削除されます。
150 DPIでは、A4の1ページが約1240 × 1754 pxになります。印刷には300を使ってください。
ファイル全体、または一部のページやスライドだけを変換します(PDFとプレゼンテーションの入力)。
変換するページまたはスライドです(例:1-3, 5, 8-10)。
UTF-8はあらゆる言語に対応します。WindowsのExcelやメモ帳で文字化けする場合は、BOM付きUTF-8を選んでください。従来の文字コードは古いソフト向けです。
LFはmacOS、Linux、コードエディター向けです。CRLFは従来のメモ帳など、古いWindowsプログラム向けです。
標準はカンマです。小数点にカンマを使う国(ドイツ、フランス、ブラジルなど)のExcelではセミコロンを使ってください。
複数のシートがあるExcelの入力用です。すべてのシート(シートごとに1セクションまたは1ファイル)か、最初のシートだけを変換します。
このツールの使い方
- 1
Wordファイルをアップロード
最大20個の .docx または .doc ファイルを追加します(1ファイルあたり95 MBまで)。Markdownには変更履歴を表示する仕組みがないため、先にWordで変更履歴を承諾または却下しておいてください。
- 2
テキストのオプションを確認
書式はシンプル、文字コードはUTF-8、改行コードはLFが初期設定で、Gitや静的サイトジェネレーターが想定する組み合わせです。画像をフォルダにまとめて出力するには、画像を含めるをオンのままにします。
- 3
変換してZIPを展開
MDに変換を押します。各文書は、.mdファイルと画像を収めたZIPで届きます。ドキュメント用フォルダに解凍してコミットしてください。
WordをMarkdownに変換するには?
.docxをアップロードしてMDに変換を押してください。#見出し、リスト、リンク、表を含む.mdファイルと、その隣のフォルダに入った画像が、1つのZIPにまとまって届きます。
docs-as-code向けにDOCXをMarkdownに変換
docs-as-codeを採用するチームの理由は1つです。ドキュメントがコードのそばにあり、同じプルリクエストを通り、同じリリースで公開されるからです。.docxはこれを妨げます。XMLパーツをまとめたZIPであり、Gitは中身のわからないバイナリとして保存するためです。1語を直しても、読める差分のない「変更されたファイル」としか表示されず、2人が同時に編集すると内容をマージできません。
Markdownはプレーンテキストなので、編集はすべて行単位の変更として見えます。2014年にJohn MacFarlaneらが、Gruberが10年前にゆるやかに記述した記法を厳密に定めたCommonMarkを公開したことで、挙動もはるかに予測しやすくなりました。GitHubは2017年に、CommonMarkをもとに独自のGitHub Flavored Markdown仕様を定め、現在の多くのREADMEが使うパイプ表、タスクリスト、取り消し線を加えました。
逆方向、つまりMarkdownをWordで作業するレビュー担当者に渡したい場合は、MarkdownをDOCXに変換をご利用ください。リポジトリではなくWebページにするなら、DOCXをHTMLに変換のほうがスタイルをより多く保てます。
変換後のMarkdownの例
## リリース前チェックリスト リリースにタグを付ける前に、次の点を確認します。 - **main** でテストが通っている - 変更履歴にマージ済みのPRがすべて載っている | 手順 | 担当 | | --- | --- | | ビルド | CI | | 公開 | メンテナー | 
変換したMarkdownが表示される場所
| 機関 | 要件 | 出典 |
|---|---|---|
| GitHub | GitHub Flavored Markdownで、リポジトリ内のREADME.mdとすべての.mdファイルを表示します | github.com |
| Hugo | CommonMark準拠のパーサーで、.mdのコンテンツファイルからページを生成します | gohugo.io |
| Jekyll | フロントマター付きの.mdファイルをページに変換します。GitHub Pagesの基盤となるエンジンです | jekyllrb.com |
| Docusaurus | docsフォルダ内の.mdと.mdxファイルを、ドキュメントページとして読み込みます | docusaurus.io |
DOCX
Microsoft Word ドキュメント
DOCX は、Office 2007 以降の Microsoft Word の標準ドキュメント形式で、Office Open XML 標準(ECMA-376、ISO/IEC 29500)に基づいています。テキスト、スタイル、画像、表、コメント、変更履歴を収めた XML ファイルの ZIP パッケージです。オフィス、学校、就職活動で、編集可能な文書として最もよく使われる形式です。Word、Google ドキュメント、LibreOffice、Pages の間では、特に複雑な書式の場合にレイアウトが少しずれることがあります。ほとんどのワープロソフトで DOCX を開けます。
- 圧縮方式
- –
- 透過
- –
- アニメーション
- –
- 登場時期
- 2007 · Microsoft
MD
Markdown
Markdownは、2004年にJohn Gruberが作った軽量マークアップ記法です。見出しの#、強調の*、リストの-など、プレーンテキストの記号を使い、そのままでも読みやすく、きれいにHTMLへ変換できます。READMEファイル、ドキュメント、Wiki、ノートアプリ、多くの静的サイトジェネレーターの標準です。CommonMarkやGitHub Flavored Markdownなど複数の方言があり、表などの細部が異なります。.mdファイルはどのテキストエディタでも開けます。
- 圧縮方式
- –
- 透過
- –
- アニメーション
- –
- 登場時期
- 2004 · John Gruber
DOCXをMarkdownに変換するのは、文書をコードのワークフローに移すときです。たとえばREADMEやドキュメントサイト、Gitで管理するナレッジベースなどで、プレーンテキストなら差分を確認でき、プルリクエストでレビューでき、多くのツールで表示できます。
Markdownに対応するものがないWordの機能
変換前に対策しておきたいこと
- フォント、色、ページレイアウトは破棄されます。Markdownは構造を記述するもので、見た目はサイトのテーマが決めます
- 変更履歴とコメントは引き継がれないため、先にWordで解決しておいてください
- ヘッダー、フッター、ページ番号は.mdファイルでは扱えません
- テキストボックスと文字列の折り返し付き画像は、通常の段落と画像リンクになります
- 見出し2のスタイルではなく、太字16 ptで手動整形した見出しは太字テキストになります。先に正しい見出しスタイルを適用してください
- 下線にはMarkdownの記法がないため、削除されるかHTMLとして残ります
DOCXからMarkdownへの変換に関するよくある質問
DOCXからMDへの変換は、どのMarkdown方言に従いますか？
見出し、強調、リスト、リンク、コードはCommonMarkに従い、表はGitHub Flavored Markdownのパイプ記法で出力します。GitHub、GitLab、Hugo、Jekyll、Docusaurusはいずれもこの組み合わせを表示できます。
結合された表のセルはどうなりますか？
Markdownのパイプ表にはセル結合がないため、結合されたセルは個別のセルに分割され、テキストは先頭のセルに入ります。複雑な表は.md内でHTMLとして作り直すか、変換前にWordで単純な構成にしてください。
Word文書内の画像はどこに保存されますか？
画像を含めるをオンにすると、すべての画像が別ファイルとしてZIPに保存され、Markdownからは images/figure-1.png のような相対パスでリンクされます。.mdファイルを移動するときは、画像フォルダも隣に置いたままにしてください。
Wordの脚注はMarkdownに残りますか？
CommonMarkには脚注の記法がありませんが、GitHubは2021年に [^1] 形式の脚注に対応し、多くのサイトジェネレーターも対応しています。お使いのレンダラーが対応していない場合、脚注のテキストは末尾に通常の段落として表示されます。
この方法でGoogleドキュメントをMarkdownに変換できますか？
はい。Googleドキュメントでファイル > ダウンロード > Microsoft Word (.docx)を選び、そのファイルをここにアップロードしてください。Googleドキュメント自体にもMarkdownのダウンロード機能があり、単純な文書ならそちらでも十分です。
