Markdownの書き方:例でわかる記法
Markdownなら、いくつかの簡単な記号だけで文章に書式を付けられます。基本の記法は数分で覚えられ、その後で表やタスクリスト、コードブロックも使えます。
基本の記法
| 要素 | Markdown |
|---|---|
| 見出し | # タイトル、## 章、### 節 |
| 太字 | **テキスト** または __テキスト__ |
| 斜体 | *テキスト* または _テキスト_ |
| リンク | [テキスト](https://example.com) |
| 画像 |  |
| リスト | - 項目 または 1. 項目 |
| 引用 | > テキスト |
| 改行 | 行末にスペース2つ |
拡張の記法
GitHub形式のMarkdownでは、縦線とハイフンで作る表、- [ ] と - [x] のタスクリスト、~~2つのチルダ~~ の取り消し線、3つのバッククォートで囲むコードブロック、そして自動でリンクになるURLが使えます。
すべてのアプリがすべての拡張に対応しているわけではありません。RedditとGitHubは表に対応していますが、Discordは非対応で、Slackは独自の簡易な書式を使います。公開先でのプレビューを確認しましょう。
よくある間違い
- リストや見出しの前の空行を忘れ、前の段落とつながってしまう。
- ** テキスト ** のようにアスタリスクの内側にスペースを入れて、太字にならない。
- 入れ子のリストでTabとスペースを混ぜる。
- 表の見出し行の下にハイフンの行を書き忘れる。