YouTube解説まとめ · 実践マニュアル

5分でわかるMarkdown入門 & 実践チートシート

ジェネレーションB「5分でわかるMarkdown入門」動画準拠の手書き・執筆ガイド

1 Markdownの本質：見た目ではなく「文章の構造」を作る
Markdownの強み
  • マウス不要：キーボードだけで見出しやリストを作成可能
  • 集中が切れない：フォントや色選びで思考が中断されない
  • 未来永劫開ける：ただのプレーンテキスト（.md）なので10年後・20年後も閲覧可能
Word と Markdown の役割分担

Markdown（設計図）

思考やアイデアを落とさずに書き出し、骨組みを作る（メモ・下書き・ドキュメント作成に最適）。

Word（最終仕上げ）

設計図に装飾・レイアウトを施し、最終成果物の見た目をきっちり作り込むためのツール。

2 基本記法チートシート（これだけで書ける主要記法）
要素 書き方（Markdown記号） 表示イメージ・解説
大見出し (H1) # タイトル 文章全体の主題（シャープの後に半角スペース）
中見出し (H2) ## セクション名 章・セクションの区切り
小見出し (H3) ### サブタイトル 中見出し内の個別項目
箇条書きリスト - 項目1 または * 項目1 行頭にハイフン＋半角スペース（1行に1つの要点）
ネスト（階層化） - サブ項目 行頭に半角スペース2つ（または4つ）を入れてハイフン
太字（強調） **強調したい文字** アスタリスク2つで挟む
コードブロック ```
コードやコマンド
```		 バッククォート3つで挟む（コピー用コマンド等に最適）
💡 執筆をスムーズにする3つのコツ
1. 先に見出しだけを書く：見出しは「文章の地図」。骨組みを先につくることで話の脱線を防ぐ。
2. 箇条書きは「1行1メッセージ」：1つのリスト項目に色々詰め込まず、要点ごとに改行する。
3. コマンド・プログラムはコードブロックで囲む：読者がどこをコピペすべきか一目で分かる。
3 初心者が必ずハマる「2大トラブル」と対処法
トラブル1：改行したはずがくっつく

Enterを1回押しただけでは、Markdownの規格上「同じ段落の続き」として扱われてしまい一行に繋がってしまいます。

✅ 解決策：空行を1行挟む
段落を分けたいときは、間に何もない行（空行）を1つ入れるのが絶対ルールです。
（行末に半角スペース2つを入れて改行する方法もあります）
トラブル2：表（テーブル）が表示されない

記法通りに書いても表にならない場合があります。これはあなたのミスではなく、Markdownの基本仕様に表が含まれていないためです。

✅ 解決策：環境側の対応を確認する
表は「拡張仕様（GFMなど）」です。使っているメモ帳や表示ビューアが表に対応しているか確認しましょう。崩れても「見る側の環境の問題かも」と考える視点が大切です。
4 実践ワークフロー（3ステップ & 最終変換先）
  1. 書く（Write）

    VSCodeやメモ帳など、使い慣れたエディタでキーボード入力に没頭。保存時は拡張子 .md（例: README.md, memo.md）で保存します。

  2. プレビューする（Preview）

    VSCodeでは Ctrl + K → V（または Ctrl + Shift + V）で横にプレビュー画面を表示し、見た目をチェック。

  3. 変換する（Convert）

    PDFやHTMLへの書き出しは執筆中の早い段階ではなく、「本当に最後の最後」に行います。

配布・出力のゴール 最適な変換先形式 理由・用途
Webサイトやブログに載せる HTML ブラウザでそのまま閲覧できる形式
誰かに読んでもらう（閲覧専用） PDF どの端末でもレイアウトが一切崩れない
相手にも編集・追記してもらう Word (.docx) 相手の利用環境に合わせて共同編集する
5 今日からできる最初の一歩

覚えるべきは最初から全て暗記することではありません。まずは以下の2つだけを使って、VSCodeやメモ帳で小さなメモを作ってみましょう。

# 今日やること - VSCodeのショートカットを復習 - Markdownでメモを1つ書いてみる - 次の作業の骨組みを整理

「こんなに手軽に構造化できる」という指の感覚を身につけるだけで、これからのドキュメント作成速度が劇的に向上します。