00

結論から

  • Markdownは、文字記号で文書の構造を表しHTMLに変換できるプレーンテキストの文書形式で、派生構文同士の互換性は保証されません。
  • WindowsやMacでは、プレーンテキストを扱うエディターの「開く」からファイルを選びます。スマートフォンでは、テキストファイルを開けるアプリを使います。ブラウザーで整形表示する場合は、文書の派生構文に対応した変換ツールでHTMLに変換し、結果を確認します。
  • プレーンテキスト表示のリスクは比較的低いものの、悪意のあるUnicode制御文字で表示方向が変わる場合があります。HTMLプレビューには、スクリプト実行、リダイレクト、外部コンテンツのダウンロード、個人情報の送信といったリスクがあります。出力を確認し、危険なマークアップを除去または遮断してください。[RFC 7763の第2節](https://www.rfc-editor.org/rfc/rfc7763.html#section-2)に説明があります。
01

Markdownファイル(.md・.markdown)の開き方と変換

.mdまたは.markdownファイルには、人が読める元のテキストが入っています。元の構文は見出し、リスト、引用、コード、強調、リンク、画像に対応しています。[Markdownの原作者による説明](https://daringfireball.net/projects/markdown/)を参照できます。

元ファイルは残す

文書の派生構文に対応するMarkdownからHTMLへの変換ツールを使い、出力を確認します。元の構文ではHTMLを直接埋め込めますが、ブロックレベルのHTML内ではMarkdown記法を解析しません。[構文の公式説明](https://daringfireball.net/projects/markdown/syntax)を参照してください。

02

開き方

WindowsやMacでは、プレーンテキストを扱うエディターの「開く」からファイルを選びます。スマートフォンでは、テキストファイルを開けるアプリを使います。ブラウザーで整形表示する場合は、文書の派生構文に対応した変換ツールでHTMLに変換し、結果を確認します。

中身を見たいだけ

WindowsやMacでは、プレーンテキストを扱うエディターの「開く」からファイルを選びます。スマートフォンでは、テキストファイルを開けるアプリを使います。ブラウザーで整形表示する場合は、文書の派生構文に対応した変換ツールでHTMLに変換し、結果を確認します。

誰かに送りたい

文書の派生構文に対応するMarkdownからHTMLへの変換ツールを使い、出力を確認します。元の構文ではHTMLを直接埋め込めますが、ブロックレベルのHTML内ではMarkdown記法を解析しません。[構文の公式説明](https://daringfireball.net/projects/markdown/syntax)を参照してください。

03

安全チェック

プレーンテキスト表示のリスクは比較的低いものの、悪意のあるUnicode制御文字で表示方向が変わる場合があります。HTMLプレビューには、スクリプト実行、リダイレクト、外部コンテンツのダウンロード、個人情報の送信といったリスクがあります。出力を確認し、危険なマークアップを除去または遮断してください。[RFC 7763の第2節](https://www.rfc-editor.org/rfc/rfc7763.html#section-2)に説明があります。

こんなときは、いったん手を止める

送り主が分からない、拡張子が二重になっている、中身が拡張子と合わない——一つでも当てはまるなら、開く前に確かめてください。

04

変換するときは

文書の派生構文に対応するMarkdownからHTMLへの変換ツールを使い、出力を確認します。元の構文ではHTMLを直接埋め込めますが、ブロックレベルのHTML内ではMarkdown記法を解析しません。[構文の公式説明](https://daringfireball.net/projects/markdown/syntax)を参照してください。

変換する前に

元ファイルではなくコピーを変換し、変換後に画質・メタデータ・レイアウトを元と見比べてください。

05

よくある質問

Markdownファイルとは何ですか?何に使いますか?

見出し、リスト、リンクなどを文字記号で表すプレーンテキストの文書です。一般的な拡張子は.mdと.markdownで、HTMLに変換できます。

WindowsでMDファイルを開く方法は?

プレーンテキストを扱うエディターを起動し、「開く」から.mdファイルを選びます。元のテキストを読んだり編集したりできます。整形表示にはMarkdownの描画機能が必要です。

MacでMarkdownファイルを開く方法は?

プレーンテキストを扱うエディターの「開く」から選びます。整形された文書を見るには、そのファイルのMarkdown派生構文に対応するビューアーを使います。

スマートフォンでMarkdownファイルを開く方法は?

テキストファイルを開けるアプリで読みます。整形表示を使う場合は、アプリが文書のMarkdown派生構文に対応しているか確認してください。

Markdownをブラウザーで表示する方法は?

文書の派生構文に対応するプレビューを使うか、HTMLに変換してブラウザーで開きます。ファイルのアップロードやHTMLの除去処理は、利用するサービスによって異なります。

Markdownの表示がエディターによって違う原因は?

派生構文が異なると、記法が無視されたり別の意味で処理されたりします。対応する構文を確認してください。元のMarkdownでは、HTMLブロック内のMarkdown記法も解析されません。

文書にはMarkdownとHTMLのどちらを使うべきですか?

読みやすいプレーンテキストに簡単な構造を付けて書くならMarkdownが適しています。ページのマークアップを直接表すならHTMLを使います。MarkdownはHTMLに変換できます。

MarkdownをHTMLに変換するときに書式を保つ方法は?

元の派生構文に対応する変換ツールを選び、出力と元の文書を比較します。派生構文間で書式の維持は保証されません。元のMarkdownではHTMLブロック内の記法も解析されません。

MarkdownプレビューでHTMLのスクリプトが実行されることはありますか?

あります。ビューアーが動作を伴う埋め込みHTMLを許可すると、スクリプト実行や外部アクセスなどが起こり得ます。マークアップの除去や遮断を利用し、不明なファイルは先にプレーンテキストで確認してください。

MarkdownファイルのMIMEタイプとマジックナンバーは何ですか?

RFC 7763の登録はtext/markdownで、拡張子は.mdと.markdownです。マジックナンバーはなく、識別用の固定バイト列は定められていません。

06

関連する形式

参考資料

Daring Fireball: Markdown · 格式原作者 John Gruber 的官方网站

Markdown Syntax Documentation · 格式原作者发布的语法说明

RFC 7763: The text/markdown Media Type · IETF 发布的 Markdown 媒体类型注册文档