結論から
- Markdownは、文字記号で文書の構造を表しHTMLに変換できるプレーンテキストの文書形式で、派生構文同士の互換性は保証されません。
- WindowsやMacでは、プレーンテキストを扱うエディターの「開く」からファイルを選びます。スマートフォンでは、テキストファイルを開けるアプリを使います。ブラウザーで整形表示する場合は、文書の派生構文に対応した変換ツールでHTMLに変換し、結果を確認します。
- プレーンテキスト表示のリスクは比較的低いものの、悪意のあるUnicode制御文字で表示方向が変わる場合があります。HTMLプレビューには、スクリプト実行、リダイレクト、外部コンテンツのダウンロード、個人情報の送信といったリスクがあります。出力を確認し、危険なマークアップを除去または遮断してください。[RFC 7763の第2節](https://www.rfc-editor.org/rfc/rfc7763.html#section-2)に説明があります。
Markdownファイル(.md・.markdown)の開き方と変換
.mdまたは.markdownファイルには、人が読める元のテキストが入っています。元の構文は見出し、リスト、引用、コード、強調、リンク、画像に対応しています。[Markdownの原作者による説明](https://daringfireball.net/projects/markdown/)を参照できます。
文書の派生構文に対応するMarkdownからHTMLへの変換ツールを使い、出力を確認します。元の構文ではHTMLを直接埋め込めますが、ブロックレベルのHTML内ではMarkdown記法を解析しません。[構文の公式説明](https://daringfireball.net/projects/markdown/syntax)を参照してください。
開き方
WindowsやMacでは、プレーンテキストを扱うエディターの「開く」からファイルを選びます。スマートフォンでは、テキストファイルを開けるアプリを使います。ブラウザーで整形表示する場合は、文書の派生構文に対応した変換ツールでHTMLに変換し、結果を確認します。
WindowsやMacでは、プレーンテキストを扱うエディターの「開く」からファイルを選びます。スマートフォンでは、テキストファイルを開けるアプリを使います。ブラウザーで整形表示する場合は、文書の派生構文に対応した変換ツールでHTMLに変換し、結果を確認します。
文書の派生構文に対応するMarkdownからHTMLへの変換ツールを使い、出力を確認します。元の構文ではHTMLを直接埋め込めますが、ブロックレベルのHTML内ではMarkdown記法を解析しません。[構文の公式説明](https://daringfireball.net/projects/markdown/syntax)を参照してください。
安全チェック
プレーンテキスト表示のリスクは比較的低いものの、悪意のあるUnicode制御文字で表示方向が変わる場合があります。HTMLプレビューには、スクリプト実行、リダイレクト、外部コンテンツのダウンロード、個人情報の送信といったリスクがあります。出力を確認し、危険なマークアップを除去または遮断してください。[RFC 7763の第2節](https://www.rfc-editor.org/rfc/rfc7763.html#section-2)に説明があります。
送り主が分からない、拡張子が二重になっている、中身が拡張子と合わない——一つでも当てはまるなら、開く前に確かめてください。
変換するときは
文書の派生構文に対応するMarkdownからHTMLへの変換ツールを使い、出力を確認します。元の構文ではHTMLを直接埋め込めますが、ブロックレベルのHTML内ではMarkdown記法を解析しません。[構文の公式説明](https://daringfireball.net/projects/markdown/syntax)を参照してください。
元ファイルではなくコピーを変換し、変換後に画質・メタデータ・レイアウトを元と見比べてください。
よくある質問
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です。マジックナンバーはなく、識別用の固定バイト列は定められていません。
関連する形式
参考資料
Daring Fireball: Markdown · 格式原作者 John Gruber 的官方网站
Markdown Syntax Documentation · 格式原作者发布的语法说明
RFC 7763: The text/markdown Media Type · IETF 发布的 Markdown 媒体类型注册文档