目次
第1章 Markdownが活きる場面
1.1 ITエンジニアの日常とMarkdown
- 1.1.1 さまざまな職種で求められる「書く」スキル
- 1.1.2 テキストで伝える仕事だからこそ
1.2 Markdownが使われる場面
- 1.2.1 ドキュメント作成
- 1.2.2 チーム共有＆ナレッジ管理
- 1.2.3 情報発信
- 1.2.4 生成AI活用
- 1.2.5 その他のMarkdown対応ツール
1.3 Markdownを学ぶメリット
- 1.3.1 手軽に始められる
- 1.3.2 使える場面が広い
- 1.3.3 長く使える
1.4 本書の構成と読み方
- 1.4.1 本書の構成
- 1.4.2 読者タイプ別の読み方
- 1.4.3 本書で扱わないこと
- 1.4.4 サンプルの読み方
- 1.4.5 本書の表記について
- 1.4.6 動作確認環境
- 【コラム】デジタル庁も推進するMarkdown
第2章 Markdownの基礎
2.1 Markdownとは何か
- 2.1.1 Markdownの誕生
- 2.1.2 設計思想は「読みやすさが優先」
- 2.1.3 Markdownの本質：テキストに構造を与える記法
- 2.1.4 HTMLとの関係
2.2 プレーンテキストの強み
- 2.2.1 可搬性：どこでも開ける、いつまでも読める
- 2.2.2 バージョン管理との相性：差分が見える
- 2.2.3 ツールを選ばず扱える
- 2.2.4 Markdownが適さない用途
2.3 基本的な考え方
- 2.3.1 構造を意識して書く
- 2.3.2 「方言」の問題
- 2.3.3 方言との付き合い方
2.4 まず覚える7つの記法
- 2.4.1 見出し：文書に構造を与える
- 2.4.2 リスト：情報を整理して伝える
- 2.4.3 コードブロック：コードやコマンドを明示する
- 2.4.4 引用：他者の言葉を区別する
- 2.4.5 太字・取り消し線：重要な語句を強調する
- 2.4.6 リンク：参照先を示す
- 2.4.7 表：データを整理して見せる
- 2.4.8 基本記法を組み合わせる
2.5 実際に書いてみよう
- 2.5.1 オンラインエディタで試す
- 2.5.2 Windowsメモ帳で始める
- 2.5.3 macOSのメモアプリで始める
- 2.5.4 ハンズオン演習
- 【コラム】Markdownを支えるGFM公式仕様書
第3章 ドキュメント作成での活用術
3.1 READMEの書き方
- 3.1.1 コードが本文に埋もれるREADME
- 3.1.2 プロジェクト概要の伝え方
- 3.1.3 インストール手順の書き方
- 3.1.4 使用例の示し方
- 3.1.5 READMEの全体構成
3.2 設計書・仕様書の書き方
- 3.2.1 パラメータが文章に溶けた設計書
- 3.2.2 見出し階層とセクション設計
- 3.2.3 API仕様の書き方
- 3.2.4 要件とインフラ構成の整理
3.3 議事録の書き方
- 3.3.1 決定事項が探せない議事録
- 3.3.2 見出しとリストで構造化する
- 3.3.3 タスクリストの活用
3.4 技術ブログの書き方
- 3.4.1 読みやすい記事構成
- 3.4.2 コードの効果的な見せ方
第4章 生成AIでの活用術
4.1 なぜMarkdownで生成AIの回答の質が上がるのか
- 4.1.1 構造化された入力の例
- 4.1.2 生成AIに伝わるMarkdownの書き方
- 4.1.3 生成AIの回答をMarkdownで受け取る
4.2 作りたいものを相談する
- 4.2.1 機能の実装方針を相談する
- 4.2.2 技術選定を相談する
- 4.2.3 構成を相談する
4.3 コードの相談・レビューを依頼する
- 4.3.1 コードと説明を分ける
- 4.3.2 エラーを相談する
- 4.3.3 コードレビューを依頼する
4.4 ドキュメントを生成する
- 4.4.1 テンプレートで出力形式を指定する
- 4.4.2 コードからドキュメントを生成する
4.5 AIの回答を活用する
- 4.5.1 Markdown形式で回答を受け取る
- 4.5.2 会話をナレッジとして残す
- 【コラム】コーディングエージェントとMarkdown
第5章 チーム共有＆ナレッジ管理での活用術
5.1 チャットで情報を構造化して伝える（Slack・Teams）
- 5.1.1 チャットは「1発で伝わる」が理想
- 5.1.2 報告・共有のメッセージ
- 5.1.3 質問・依頼のメッセージ
- 5.1.4 まとめ
5.2 Markdownで情報を蓄積する（Notion・Obsidian）
- 5.2.1 Notionでチームドキュメントを書く
- 5.2.2 Obsidianで個人ナレッジを積み上げる
- 5.2.3 ツールは変わる、Markdownは残る
- 【コラム】Markdown方言はなぜ生まれたのか
第6章 Markdown活用を加速するツール
6.1 編集環境を整える
- 6.1.1 組み込み機能だけでここまでできる
- 6.1.2 拡張機能でさらに便利に
- 6.1.3 Markdown編集に役立つ設定（settings.json）
6.2 markdownlintで品質を保つ
- 6.2.1 設定ファイルを作る
- 6.2.2 よく調整するルール
- 6.2.3 保存時の自動修正
- 6.2.4 チーム開発での活用
6.3 Markdownから成果物を作る
- 6.3.1 Marp ─ Markdownでスライドを作る
- 6.3.2 LibreOffice ─ MarkdownをPDF・Wordに変換する
6.4 明日の会議から始めよう
- 【コラム】人間にも、AIにも伝わるドキュメント
第7章 Markdown文法リファレンス ― 基礎編
リファレンスの読み方
- 各節の構成
- 入力と表示結果の見方
- 方言対応表の見方
- 推奨する書き方について
7.1 見出し
- 7.1.1 基本構文
- 7.1.2 記述例と表示結果
- 7.1.3 推奨する書き方
- 7.1.4 方言対応表
- 7.1.5 よくある間違いと対処法
- 7.1.6 関連する記法
7.2 文字装飾
- 7.2.1 基本構文
- 7.2.2 記述例と表示結果
- 7.2.3 推奨する書き方
- 7.2.4 方言対応表
- 7.2.5 よくある間違いと対処法
- 7.2.6 関連する記法
7.3 リスト
- 7.3.1 基本構文
- 7.3.2 記述例と表示結果
- 7.3.3 推奨する書き方
- 7.3.4 方言対応表
- 7.3.5 よくある間違いと対処法
- 7.3.6 関連する記法
7.4 リンク
- 7.4.1 基本構文
- 7.4.2 記述例と表示結果
- 7.4.3 推奨する書き方
- 7.4.4 方言対応表
- 7.4.5 よくある間違いと対処法
- 7.4.6 関連する記法
7.5 画像
- 7.5.1 基本構文
- 7.5.2 記述例と表示結果
- 7.5.3 推奨する書き方
- 7.5.4 方言対応表
- 7.5.5 よくある間違いと対処法
- 7.5.6 関連する記法
7.6 引用
- 7.6.1 基本構文
- 7.6.2 記述例と表示結果
- 7.6.3 推奨する書き方
- 7.6.4 方言対応表
- 7.6.5 よくある間違いと対処法
- 7.6.6 関連する記法
7.7 コードブロック
- 7.7.1 基本構文
- 7.7.2 記述例と表示結果
- 7.7.3 推奨する書き方
- 7.7.4 方言対応表
- 7.7.5 よくある間違いと対処法
- 7.7.6 関連する記法
7.8 表
- 7.8.1 基本構文
- 7.8.2 記述例と表示結果
- 7.8.3 推奨する書き方
- 7.8.4 方言対応表
- 7.8.5 よくある間違いと対処法
- 7.8.6 関連する記法
7.9 水平線
- 7.9.1 基本構文
- 7.9.2 記述例と表示結果
- 7.9.3 推奨する書き方
- 7.9.4 方言対応表
- 7.9.5 よくある間違いと対処法
- 7.9.6 関連する記法
7.10 段落と改行
- 7.10.1 段落の基本
- 7.10.2 段落内での改行
- 7.10.3 記述例と表示結果
- 7.10.4 推奨する書き方
- 7.10.5 方言対応表
- 7.10.6 よくある間違いと対処法
- 7.10.7 関連する記法
第8章 Markdown文法リファレンス ― 応用編
応用編の読み方
8.1 脚注
- 8.1.1 基本構文
- 8.1.2 記述例と表示結果
- 8.1.3 推奨する書き方
- 8.1.4 方言対応表
- 8.1.5 よくある間違いと対処法
- 8.1.6 関連する記法
8.2 アンカーリンク
- 8.2.1 基本構文
- 8.2.2 記述例と表示結果
- 8.2.3 推奨する書き方
- 8.2.4 方言対応表
- 8.2.5 よくある間違いと対処法
- 8.2.6 関連する記法
8.3 目次の自動生成
- 8.3.1 基本構文
- 8.3.2 推奨する書き方
- 8.3.3 方言対応表
- 8.3.4 関連する記法
8.4 アラート・コールアウト
- 8.4.1 基本構文
- 8.4.2 記述例と表示結果
- 8.4.3 推奨する書き方
- 8.4.4 方言対応表
- 8.4.5 よくある間違いと対処法
- 8.4.6 関連する記法
8.5 フローチャート・図表現（Mermaid）
- 8.5.1 対応する図の種類
- 8.5.2 基本構文
- 8.5.3 記述例と表示結果
- 8.5.4 その他のMermaid図
- 8.5.5 推奨する書き方
- 8.5.6 方言対応表
- 8.5.7 よくある間違いと対処法
- 8.5.8 関連する記法
8.6 数式表現
- 8.6.1 基本構文
- 8.6.2 記述例と表示結果
- 8.6.3 推奨する書き方
- 8.6.4 方言対応表
- 8.6.5 よくある間違いと対処法
- 8.6.6 関連する記法
8.7 折りたたみ
- 8.7.1 基本構文
- 8.7.2 記述例と表示結果
- 8.7.3 推奨する書き方
- 8.7.4 方言対応表
- 8.7.5 関連する記法
8.8 HTML埋め込み
- 8.8.1 基本構文
- 8.8.2 記述例と表示結果
- 8.8.3 推奨する書き方
- 8.8.4 方言対応表
- 8.8.5 よくある間違いと対処法
- 8.8.6 関連する記法
8.9 エスケープ
- 8.9.1 基本構文
- 8.9.2 記述例と表示結果
- 8.9.3 推奨する書き方
- 8.9.4 方言対応表
- 8.9.5 関連する記法
8.10 その他の記法
- 8.10.1 ハイライト
- 8.10.2 絵文字ショートコード
- 8.10.3 Base64インライン画像
- 8.10.4 Front Matter（メタデータ）
- 8.10.5 方言対応表