Markdownエディター

なぜ Markdown を使うのか？

Markdown クイックリファレンス

Markdown が使われる場所

Markdown はデベロッパードキュメントのユニバーサルフォーマットです。GitHub README、Notion ページ、Obsidian ノート、dev.to 記事、そして無数の静的サイトジェネレーターすべてが Markdown をレンダリングします。習得に数分かかるだけで、リッチテキストエディターとの格闘に費やす何時間もの時間を節約できます。

GitHub と GitLab（README・issue・PR）、Confluence、Notion、Jira、Stack Overflow、Reddit、Discord、Obsidian、Bear、Typora、Jekyll、Hugo、Gatsby、Next.js MDX、そして事実上すべてのドキュメントプラットフォーム。Markdown ファイルの拡張子は .md です。

オープンソースプロジェクトの README を作成する開発者は、GitHub にコミットする前にライブプレビューでテーブルのフォーマット・コードブロックの構文ハイライト・見出し階層を確認します。静的サイトジェネレーター（Hugo・Jekyll・Docusaurus）向けにドキュメントを書くテクニカルライターは、サイトビルドにプッシュする前に GFM テーブルのレンダリングを確認します。dev.to・Hashnode・Medium（Markdown を受け入れる）向けのブロガーは、コールアウトブロックやコードフェンスを含む投稿構造をプレビューします。Obsidian や Notion で Markdown ノートを取る学生は、アプリを開かずに下書きとプレビューを行います。

GFM テーブルは最もよく使われながら最も扱いにくい Markdown 機能の一つです。列の配置はセパレーター行で制御します：:--- で左揃え、:---: で中央揃え、---: で右揃え。ソースでは列が視覚的に揃っている必要はありません——パイプ文字の間隔が不均等でも有効です。列数が多いテーブルでは、このエディターのプレビューペインで列数の不一致によるテーブルレイアウトの崩れがすぐにわかります。ヒント：テーブルセル内のパイプ文字は \| としてエスケープしなければなりません——エスケープされていないパイプは列区切りとして解釈されテーブル構造が壊れます。

Markdown はコンテンツを Git でバージョン管理する場合、ツール間の移植性が重要な場合（同じ .md ファイルが VS Code・Obsidian・Typora・GitHub で一貫してレンダリングされる）、フォーマットの決断よりも構造に集中したい場合に優れています。リッチテキストエディター（Google Docs・Word・Notion のネイティブエディター）は、構文に慣れていない非技術系チームメンバーとコラボレーションする場合、変更追跡とコメントが必要な場合、または細かいタイポグラフィ制御（カスタムフォント・精密なスペーシング）が必要な場合に優れています。技術ドキュメントとデベロッパーツールには、Markdown がデフォルトである理由があります——生のまま読んでも読みやすいのです。

• # 見出し1、## 見出し2、### 見出し3
• **太字**、*斜体*、~~取り消し線~~
• - 箇条書きリスト、1. 番号付きリスト
• [リンクテキスト](https://url.com)
• 
• `インラインコード`、```コードブロック```
• > 引用
• --- で水平線