Markdownプレビュー
Markdownをリアルタイムに編集・プレビュー
Markdownプレビュー の使い方
Markdownをリアルタイムに編集・プレビュー 無料オンラインツール、登録不要、広告なし。今すぐ無料でお使いいただけます。
Markdownはどのような場面で使われますか?
Markdownは2004年にJohn Gruberが作成した軽量マークアップ言語です。シンプルなプレーンテキスト構文でフォーマットを追加します。そのままでも読みやすく、HTMLに簡単に変換できる、両方の利点を持つように設計されました。
- 技術ドキュメント:GitHubとGitLabのREADMEファイルはMarkdownで書かれています。すべてのオープンソースプロジェクトがインストールガイド、APIドキュメント、貢献ガイドラインに使っています。日本のOSSコミュニティでも標準となっています。
- 静的サイトジェネレーター:Jekyll、Hugo、Gatsby、Eleventyはmarkdownファイルからウェブサイトを構築します。Markdownで書き、自動的にHTMLとして公開します。
- ノートアプリ:Notion、Obsidian、Bear、Typoraはリッチテキストノートにmarkdownを使います。バージョン管理と互換性を保ちながらポータブルです。Obsidianは日本のナレッジワーカーにも人気があります。
- フォーラムとチャット:Reddit、Stack Overflow、Discord、Slackはメッセージのフォーマットにmarkdownをサポートしています。技術的なオンラインコミュニティの文化に浸透しています。
- ブログプラットフォーム:Ghost、Zenn(日本の技術ブログプラットフォーム)、note(日本)、Qiitaなどがmarkdownを主要な執筆形式として使用しています。
基本的な構文:# H1、## H2、**太字**、*斜体*、[リンク](URL)、、`インラインコード`、```コードブロック```。テーブルは縦棒を使います:| 列1 | 列2 |。
Frequently Asked Questions
MarkdownとHTMLの違いは何ですか?
HTMLはブラウザが解釈する本物の言語です。Markdownは自動的にHTMLに変換されるシンプルな構文です。Markdownの'**太字**'はHTMLの'<strong>太字</strong>'になります。Markdownははるかに速く書けてプレーンテキストとして読みやすいですが、HTMLはスタイルと構造のより細かい制御ができます。
どのMarkdownダイアレクトを使うべきですか?
CommonMarkが標準化された仕様です。GitHub Flavored Markdown(GFM)はテーブル、取り消し線、タスクリスト、コードの構文ハイライトを追加し、最も広く使われています。GitHub READMEファイルや現代のドキュメントプラットフォームにはGFMを使用してください。
MarkdownにHTMLを含めることができますか?
はい。ほとんどのMarkdownパーサーはインラインHTMLを許可しています。色付きテキスト、カスタムCSSクラス、iframeなど、Markdownがサポートしない要素にHTMLを使用できます。一部のプラットフォーム(GitHub README)はXSS攻撃を防ぐためにHTMLを除去します。
MarkdownでTableを追加するには?
縦棒文字を使用します:1行目に| 見出し1 | 見出し2 |、次に区切り文字として|---|---|、そしてデータ行が続きます。配置はコロンで制御します:|:---| 左揃え、|---:| 右揃え、|:---:| 中央揃え。
MarkdownのFrontmatterとは何ですか?
Frontmatterは、---で区切られたMarkdownファイルの先頭にあるYAMLブロックです。タイトル、日付、著者、タグ、説明などのメタデータを格納し、静的サイトジェネレーターがテキストファイルからWebページを構築するために使用します。
Markdown vs reStructuredText vs AsciiDoc vs HTML
Markdownが最もシンプルで広く採用されています。READMEファイル、ブログ、一般的なドキュメントに最適です。reStructuredText(RST)はより強力で、Pythonプロジェクトと複雑な技術ドキュメントのSphinxで使用されています。AsciiDocは最も包括的で、プロフェッショナルなPDF出力が必要な技術書向けです。HTMLは完全な制御ができますが冗長でソースとして読みにくいです。ほとんどのライティングとドキュメント作成ニーズにはMarkdownが適切な選択です。