この記事の要点
• #で見出し、**太字**と*斜体*でテキスト装飾
• テーブル・コードブロック・リストで構造化ドキュメントを作成
• GFM拡張でタスクリスト、メンション、絵文字が使用可能
見出し
| 記法 | 説明 |
|---|
# 見出し1 | 最大の見出し(H1) |
## 見出し2 | セクション見出し(H2) |
### 見出し3 | サブセクション(H3) |
#### 見出し4 | 小見出し(H4) |
##### 見出し5 | より小さい見出し(H5) |
###### 見出し6 | 最小の見出し(H6) |
テキスト装飾
| 記法 | 説明 |
|---|
**太字** | 太字テキスト |
*斜体* | 斜体テキスト |
***太字斜体*** | 太字かつ斜体 |
~~取り消し線~~ | 取り消し線 |
`インラインコード` | インラインコード |
<sup>上付き</sup> | 上付き文字 |
<sub>下付き</sub> | 下付き文字 |
ポイント: 見出しはH1からH6まで。ドキュメントの構造を明確にするため、見出しレベルを飛ばさない(H2の次にH4など)ようにしましょう。
リスト
| 記法 | 説明 |
|---|
- 項目 | 順序なしリスト |
* 項目 | 順序なしリスト(代替) |
1. 項目 | 順序付きリスト |
- 子項目 | ネストしたリスト(2スペース) |
- [ ] タスク | チェックボックス(未完了) |
- [x] タスク | チェックボックス(完了) |
リンクと画像
| 記法 | 説明 |
|---|
[テキスト](URL) | ハイパーリンク |
[テキスト](URL "タイトル") | タイトル付きリンク |
<URL> | 自動リンク |
 | 画像 |
 | タイトル付き画像 |
[参照][id] → [id]: URL | 参照リンク |
実践メモ: 参照リンク([テキスト][id])を使うと、URLを文末にまとめて管理でき、本文の可読性が大幅に向上します。
コードブロック
| 記法 | 説明 |
|---|
``` | コードブロック開始/終了 |
```javascript | 言語指定のコードブロック |
```python | Python用コードブロック |
```bash | シェルコマンド用 |
コード | 4スペースインデントでもコード化 |
ポイント: コードブロックには言語名(javascript、python等)を指定しましょう。シンタックスハイライトが有効になり読みやすくなります。
テーブル
| 記法 | 説明 |
|---|
| 列1 | 列2 | | テーブル行 |
|---|---| | ヘッダー区切り |
|:---| | 左寄せ |
|:---:| | 中央寄せ |
|---:| | 右寄せ |
引用とセパレーター
| 記法 | 説明 |
|---|
> 引用テキスト | 引用ブロック |
>> ネスト引用 | ネストした引用 |
--- | 水平線 |
*** | 水平線(代替) |
___ | 水平線(代替) |
注意: テーブルのヘッダー区切り行(|---|---|)は必須です。これがないとテーブルとして認識されません。
実践メモ: - [ ] タスクでチェックリストが作成可能。GitHubのIssueやPRで進捗管理に便利です。
拡張構文(GitHub Flavored Markdown)
| 記法 | 説明 |
|---|
@username | ユーザーメンション |
#123 | Issue/PRへの参照 |
:emoji: | 絵文字(例: :smile:) |
==ハイライト== | ハイライトテキスト |
^脚注^ | 脚注 |
[^1] → [^1]: 注釈 | 脚注の詳細形式 |
注意: GFM(GitHub Flavored Markdown)の拡張機能は、他のMarkdownパーサーでは動作しない場合があります。CommonMark仕様をベースにしつつ、環境固有の拡張を確認しましょう。
エスケープ
| 記法 | 説明 |
|---|
\* | アスタリスクをエスケープ |
\# | ハッシュをエスケープ |
\[ | 角括弧をエスケープ |
\\ | バックスラッシュ自体 |
参考リソース
この技術を体系的に学びたいですか?
未来学では東証プライム上場企業のITエンジニアが24時間サポート。月額24,800円から、退会金0円のオンラインIT塾です。
メールで無料相談する
← 一覧に戻る