マークダウン（Markdown）とは
マークダウンは、2004年にJohn Gruber氏が開発したプレーンテキストで書ける軽量マークアップ言語です。特別なソフトがなくてもメモ帳だけで書けますが、専用のビューアやエディタで開くと、見出しや太字、リストなどが構造化されて表示されます。
最大の特徴は「書きやすく、読みやすい」こと。HTMLのような複雑なタグを覚える必要がなく、人間がそのまま読んでも意味が通じるのが強みです。
ExcelやWordとの違い
| 項目 | Markdown | Word（.docx） | Excel（.xlsx） |
|---|---|---|---|
| ファイル形式 | プレーンテキスト（.md） | バイナリ（XML圧縮） | バイナリ（XML圧縮） |
| 編集に必要なもの | メモ帳でOK | Word（有料） | Excel（有料） |
| バージョン管理 | Gitで差分管理が完璧 | 差分管理が難しい | バイナリで管理困難 |
| 表計算 | できない | できない | 得意 |
| 見た目の自由度 | 制限あり（シンプル） | 非常に高い | 中程度 |
| 変換・連携 | HTML/PDFなどに簡単変換 | 変換が面倒 | CSVで連携が基本 |
つまり、Markdownは「文書の内容を書く」ことに特化しており、見た目の装飾や複雑な表計算はWordやExcelに任せる、という住み分けになります。
AIとの関係
Markdownが今、急速に注目されている最大の理由はAIとの相性の良さです。
- AI（LLM）はMarkdownをネイティブに理解する：ChatGPTやClaudeに「Markdownで出力して」と言うだけで、構造化された文書を返してくれます
- コードと説明文の混在が容易：コードブロックにプログラムを書き、その説明をMarkdownで書ける
- MCP連携：AIがMarkdownファイルを直接読み書きして、ドキュメント作成を自動化できる
- ナレッジベースの標準形式：多くのAIツール（Obsidian、Notionなど）の内部形式がMarkdownベース
「AIに作業を頼む→Markdownで結果を受け取る→そのまま共有する」というワークフローが、エンジニアの間で急速に標準化しています。
Markdownの基本記法
最低限覚えるべき記法を紹介します。
# 見出し1
## 見出し2
### 見出し3
**太字** と *斜体*
- 箇条書き（順序なし）
1. 番号付きリスト
2. 番号付きリスト
[リンクテキスト](https://example.com)
> 引用文
`コード（インライン）`
```（言語名）
コードブロック
```これだけ覚えれば、十分実用的な文書が書けます。
Markdownビューアで見る素晴らしさ
Markdownファイルをそのままメモ帳で開くとただのテキストですが、Markdownビューア（プレビューア）で開くと驚くほど見やすくなります。
おすすめのMarkdownビューア／エディタ
- VS Code：Ctrl+Shift+Vでプレビュー。拡張機能も豊富
- Obsidian：ナレッジ管理に特化。グラフビューも可能
- Typora：WYSIWYGタイプ。最も直感的
- GitHub / GitLab：リポジトリ上で自動的にレンダリング
- Notion：Markdownライクな操作感で人気
見出しは自動的に階層表示され、リストはインデント付き、コードはシンタックスハイライト付きで表示されるので、同じテキストファイルとは思えない見やすさになります。
その他のMarkdown拡張記法
基本記法に加えて、多くの処理系で使える拡張記法を紹介します。
テーブル（表）
パイプ（|）とハイフン（-）で表を書けます。
| 項目 | 説明 | 備考 |
|----------|-------------|--------------|
| オームの法則 | V = I x R | 直流回路の基本 |
| 消費電力 | P = V x I | AC/DCで要検討 |列の右寄せ・中央寄せも可能です。
タスクリスト（チェックボックス）
先頭に [ ] または [x] を付けると、チェックボックスとして表示されます。
- [x] 設計図を確認
- [ ] 材料を発注
- [ ] 部品を加工
- [x] 組立完了GitHubやGitLabのIssueでよく使われる記法です。
取り消し線
テキストを ~~ で囲むと打消し線が引かれます。
この方式は~~採用しない~~再検討する議事録や仕様変更の履歴で、削除した内容を残しておくのに便利です。
脚注
文書内で補足説明を入れたい場合に使います。
オームの法則は電気回路の基本です[^1]。
[^1]: ゲオルク・オーム（1789-1854）が1827年に発表。紙面の都合で本文に入れにくい補足情報を、文書末尾にまとめられます。
数式（LaTeX記法）
ObsidianやTypora、MathJax対応環境では、$ 記号で数式が書けます。
オームの法則：$V = I \times R$
消費電力：$P = V \times I$
三角関数：$\sin^2\theta + \cos^2\theta = 1$エンジニア向けの技術文書や学習ノートで重宝します。
目次（TOC）
一部のMarkdown処理系では、見出しから自動で目次を生成できます。
[[_TOC_]]長文のドキュメントでは、冒頭に目次を置くだけで読みやすさが格段に向上します。
Mermaid記法でフローチャートも書ける
Markdownの拡張記法としてMermaid（マーメイド）というものがあります。Mermaidを使うと、テキストだけでフローチャートやシーケンス図、ガントチャートなどを描くことができます。
フローチャートの例：
```mermaid
graph TD
A[開始] --> B{条件判定}
B -->|Yes| C[処理A]
B -->|No| D[処理B]
C --> E[終了]
D --> E
```シーケンス図の例：
```mermaid
sequenceDiagram
PLC->>センサー: データ要求
センサー->>PLC: 測定値返信
PLC->>サーバ: データ送信
```| Mermaid図の種類 | 用途 |
|---|---|
| graph（フローチャート） | 処理の流れ、判断分岐 |
| sequenceDiagram（シーケンス図） | 機器間の通信順序 |
| classDiagram（クラス図） | データ構造の定義 |
| stateDiagram（状態遷移図） | 装置の状態遷移 |
| gantt（ガントチャート） | 工程管理・スケジュール |
| pie（円グラフ） | 割合の表示 |
| erDiagram（ER図） | データベース設計 |
WordやExcelでは図を描くために別途ツールが必要だったり、操作に慣れが必要ですが、MermaidならMarkdownの中にテキストで図を埋め込めるので、ドキュメントと図の一元管理が可能です。図の修正もテキストを書き換えるだけなので、Gitでの差分管理も完璧です。
実践応用：PLCプログラムの仕様書をMarkdownで作る
ここで、製造業のエンジニアに特に役立つ活用例を紹介します。
近年、ChatGPTやClaudeなどのAI（LLM）にPLCのラダープログラムやST（構造化テキスト）を読み込ませると、「このプログラムの仕様書をMarkdown形式で書いて」という指示で、プログラムの動作説明書が自動生成できます。
しかも、Markdownで出力するよう指示すれば、Mermaid記法を使ってフローチャートも含めて出力してくれます。
例：AIへのプロンプト
以下のPLCプログラムを解析し、Markdown形式の仕様書を作成してください。
- 入出力一覧を表にまとめる
- シーケンスの流れをMermaidのフローチャートで図示
- 各ステップの処理内容を箇条書きで説明
- タイマーやカウンタの設定値も記載AIが生成する仕様書のイメージ：
# コンベア制御プログラム 仕様書
## 入出力一覧
| 信号名 | アドレス | 種類 | 説明 |
|--------|---------|------|------|
| START | X0 | 入力 | 起動ボタン |
| CONV_RUN | Y0 | 出力 | コンベアモータ |
## 動作フロー
```mermaid
graph TD
A[起動ボタンON] --> B{非常停止？}
B -->|No| C[コンベア起動]
B -->|Yes| D[全停止]
C --> E[ワーク検知]
E --> F[停止]
```本来なら手作業で書くのに何時間もかかる仕様書が、数分でベースが完成します。修正したい部分だけ書き換えればいいので、ドキュメント作成の負荷が劇的に下がります。
さらに、生成したMarkdownファイルをGitでバージョン管理すれば、プログラム修正と同時に仕様書も更新履歴が残るので、トレーサビリティの面でも大きなメリットがあります。
このように、Markdownは単なる文書形式ではなく、「AI × エンジニアリング」の共通基盤としての価値を持っています。
まとめ
Markdownは、以下のような場面で特に力を発揮します。
- 技術ドキュメント（README、仕様書、設計書）
- AIとのやり取り結果の保存
- Mermaidで図も一緒に管理
- 議事録や簡易報告書
- Gitでバージョン管理しながら共同編集
WordやExcelを否定するものではありませんが、「テキストベースで管理したい情報」はMarkdownに移行する流れが加速しています。特にAI時代において、Markdownは人間とAIの共通言語として、ますます重要になるでしょう。
コメント