MDファイルとは？開き方・編集・変換方法

MDファイルとMarkdownの関係

Markdownは、プレーンテキストに少ない記号を加えて文書構造を表す記法です。MDファイルは、そのMarkdownを書いたテキストファイルで、一般的に.mdという拡張子を使います。

ファイルの中に保存されるのは、整形済み画面ではなく文字と記号です。Markdown対応アプリがその記号を読み取り、見出し、リスト、リンク、表、コードとして表示します。

# 作業メモ

これは**重要な項目**です。

- 確認する
- 公開する

作業メモ（大見出し）
これは重要な項目です。（重要な項目が太字）
・確認する
・公開する

README.mdは何をするファイルか

README.mdは、フォルダーやプロジェクトの入口に置く説明文書です。ソフトウェアの目的、インストール方法、使い方、ライセンス、問い合わせ先などを書きます。GitHubなどはREADME.mdを自動でレンダリングするため、訪問者は記号ではなく整形された説明を目にします。

README.mdだけが特別なファイル形式なのではありません。通常のMarkdownに、用途を示す慣例的な名前が付いているだけです。

WindowsでMDファイルを開く・作る

既存ファイルは、メモ帳、VS Code、その他のテキストエディターから開けます。#や*が見えても壊れているわけではなく、ソースを表示している状態です。

1. プレーンテキストで作成テキストエディターにMarkdownを書きます。
2. 名前を付けて保存ファイルの種類を「すべてのファイル」にし、可能なら文字コードをUTF-8にします。
3. .mdで終わる名前にするnotes.mdと保存します。拡張子を表示して、notes.md.txtになっていないか確認します。

macOS・Linux・VS Codeで開く

macOSのテキストエディットで新しく作る場合は、リッチテキストではなく標準テキストに切り替えます。Linuxでは一般的なテキストエディターで開けます。OSではなく、利用するアプリがMarkdown表示に対応しているかがポイントです。

VS CodeはMarkdown編集とプレビューに対応しています。ファイルを開き、Windows・LinuxではCtrl+Shift+V、macOSではCmd+Shift+Vでプレビューを表示できます。

MDファイルでよく起きる問題

開けないように見える問題の多くは、拡張子、表示アプリ、画像パス、利用先のMarkdown拡張に原因があります。

MDを編集・プレビュー・変換する

編集は任意のテキストエディターでできますが、表やコードを含む文書はプレビューと並べると誤りを見つけやすくなります。特に見出し順、表、タスクリスト、画像、コードフェンス、改行を確認します。

相手がMarkdownを使わない場合は形式を変えます。閲覧・印刷用ならPDF、共同編集ならDOCX、Web公開ならHTMLが一般的です。元の.mdを残しておけば、目的ごとに出力を作り直せます。

公式仕様と参考資料

記法やアプリの動作を確認するときは、最終的に一次資料を参照します。

• CommonMark仕様
• GitHub Flavored Markdown仕様
• GitHubでの記述と書式設定
• Visual Studio CodeのMarkdownサポート

関連ツール