5分でわかるMarkdown
知らないうちにMarkdownを使ったことがあるかもしれません。Slackのメッセージで**太字**と入力したことはありますか？GitHubでREADMEを書いたことは？Redditの投稿をフォーマットしたことは？それがMarkdownです。
Markdownは、シンプルな記号を使ってプレーンテキストをフォーマットする軽量な方法です。太字、斜体、見出し、リストのためにツールバーボタンをクリックする代わりに、目的のフォーマットを示す数文字を入力します。2004年にJohn GruberとAaron Swartzによって作成され、以来、開発者、ライター、そしてWebでテキストを扱うすべての人にとってデフォルトのフォーマット言語となりました。
なぜMarkdownが存在するのか
Markdown以前は、Web用のテキストフォーマットにはHTMLを書く必要がありました。文字を太字にするには<strong>太字</strong>と入力しました。リストを作るには<ul><li>項目</li></ul>が必要でした。HTMLは強力ですが冗長で、生の状態では読みにくいものです。
Markdownは人間が読めるショートハンドを提供することでこれを解決します。生のテキストはレンダリング前でも読みやすいです。フォーマットされた出力はきれいでプロフェッショナルです。読みやすいソーステキストと洗練された出力という両方の利点を得られます。
ご存知ですか？ Markdownの設計思想は、生のテキストが「タグやフォーマット指示でマークアップされているように見えることなく、プレーンテキストとしてそのまま公開できる」ことです。これが、Markdownの構文がそれが生成するフォーマットを視覚的に示唆する文字を使用する理由です。
基本構文
Markdownを生産的に使い始めるために必要なことはすべてここにあります。
見出し
ハッシュ記号（#）を使って見出しを作成します。ハッシュが多いほど小さい見出しになります。
# 見出し1（最大）
## 見出し2
### 見出し3
#### 見出し4
太字と斜体
テキストをアスタリスクまたはアンダースコアで囲みます：
**太字テキスト**
*斜体テキスト*
***太字かつ斜体***
リスト
順序なしリストにはダッシュ、アスタリスク、プラス記号を使用します。順序付きリストには数字を使用します。
- 最初の項目
- 2番目の項目
- 3番目の項目
1. 最初のステップ
2. 2番目のステップ
3. 3番目のステップ
リンク
テキストを角括弧、URLを丸括弧で：
[ここをクリック](https://example.com)
画像
リンクと同じですが、先頭に感嘆符を付けます：
引用
大なり記号を使用します：
> これは引用です。インデントされ、異なるスタイルで表示されます。
コード
インラインコードにはバッククォート、コードブロックにはトリプルバッククォート：
`print()`関数を使用してテキストを出力します。
複数行のコードブロックには、オプションの言語識別子付きのトリプルバッククォートを使用します：
```python
def hello():
print("Hello, world!")
```
水平線
3つ以上のダッシュ、アスタリスク、またはアンダースコア：
---
テーブル
パイプとダッシュを使用します：
| 名前 | 役割 | 場所 |
| --- | --- | --- |
| Alice | 開発者 | ベルリン |
| Bob | デザイナー | ロンドン |
Markdownが使われている場所
Markdownはあらゆる場所にあります：
ソフトウェア開発
- GitHub、GitLab、Bitbucket： README、イシュー、プルリクエスト、ドキュメントはすべてMarkdownで書かれています。
- Stack Overflow： 質問と回答にMarkdownフォーマットを使用。
- コードドキュメント： 多くのドキュメントジェネレーター（Docusaurus、MkDocs、Jekyll）がソース形式としてMarkdownを使用。
コミュニケーション
- Slack： メッセージフォーマット用にMarkdownのサブセットをサポート。
- Discord： 太字、斜体、コードブロックなどにMarkdownを使用。
- Reddit： 投稿やコメントはMarkdownでフォーマット。
ライティングと出版
- ブログ： 多くの静的サイトジェネレーターがコンテンツソースとしてMarkdownファイルを使用。
- 書籍： いくつかの出版ツールがMarkdown原稿を受け付けます。
- メモ： Obsidian、Notion、Bear、TyporaなどのアプリはMarkdownを中心に構築されています。
ドキュメント
- 技術文書： APIドキュメント、ユーザーガイド、wikiでは一般的にMarkdownが使用されます。
- 社内ナレッジベース： 多くのチームがMarkdownベースのwikiを使用。
ヒント 今すぐ無料でブラウザでMarkdownをプレビュー・練習できます：Markdownで書く。入力しながらリアルタイムでフォーマット済み出力を確認できます。
Markdownのフレーバー
知っておくべきこと：Markdownにはさまざまな「フレーバー」（方言）があります。コアとなる構文はどこでも同じですが、一部のプラットフォームが拡張を追加しています：
| フレーバー | 追加機能 | 使用先 |
|---|---|---|
| CommonMark | 厳密な仕様 | 一般標準 |
| GitHub Flavored Markdown (GFM) | タスクリスト、テーブル、取り消し線、自動リンク | GitHub |
| MultiMarkdown | 脚注、引用、メタデータ | 学術執筆 |
| R Markdown | 埋め込みRコード、データ分析 | データサイエンス |
違いは主に高度な機能にあります。基本（見出し、太字、斜体、リスト、リンク、画像、コード）はどこでも同じように機能します。
よくある間違い
空白行を忘れる
Markdownでは多くの要素の前後に空白行が必要です。見出しの前には空白行が必要。リストの前後にも空白行が必要。これらの空白行を忘れることが、レンダリング問題の最も一般的な原因です。
一貫しないリストマーカー
同じリスト内で-、*、+を混在させると、予期しないレンダリングが発生する可能性があります。1つを選んで統一してください。
記号の後のスペース
一部のMarkdownプロセッサーは、見出しの#の後やリストの-の後にスペースを必要とします。安全のために常にスペースを含めてください。
# 正しい見出し
#間違った見出し
- 正しいリスト項目
-間違ったリスト項目
注意 Markdownはすべてのフォーマットニーズに対応しているわけではありません。複雑なレイアウト、色付きテキスト、精密なタイポグラフィ、印刷用ドキュメントが必要な場合は、HTML、LaTeX、またはワープロが必要かもしれません。Markdownは構造化されたテキスト中心のコンテンツに最適です。
なぜMarkdownを学ぶ価値があるのか
Markdownは5分で学べて、長期的に何時間も節約できます。覚えれば、以下のことができます：
- GitHubできれいにレンダリングされるドキュメントを書く
- マウスに触れずにSlackやDiscordでメッセージをフォーマットする
- アプリ間で持ち運べる構造化されたメモを取る
- プレーンテキストファイルからブログ記事やWebコンテンツを作成する
- フォーマット互換性の問題なしにテキストベースのドキュメントで共同作業する
投資対効果は、テック界全体で最も優れたものの一つです。
今すぐMarkdownで書き始めましょう：
無料、ブラウザで、リアルタイムプレビュー付きです。