最終更新日：2026年05月07日
マークダウンは、ただの書式ルールではありません。プレーンテキストで見出し、リスト、リンク、表を組み立てられるので、メモから技術文書まで幅広く使えます。CommonMark はMarkdownの明確な仕様を示しており、GitHub Docs でも見出し、リンク、リスト、タスクリストなどの基本記法が案内されています。
マークダウンとは何か
最初に押さえたいのは、マークダウンは「装飾を直接選ぶ」よりも「文書の意味を先に書く」考え方だという点です。見出し、段落、箇条書き、引用、コードのように、文章の構造を先に決めるので、あとからHTMLへ変換しても崩れにくくなります。
マークダウンが選ばれる理由
書きやすさと読みやすさのバランスがよいからです。記号だけで構造を表せるので、エディタが変わっても内容を追いやすく、レビューもしやすい。NotePMのMarkdown解説、GROWI Docs、DocBaseのヘルプ のように、Markdown運用を前提にした環境が今も広く使われているのは、その実用性が強い証拠です。
HTMLやリッチテキストとの違い
HTMLは細かく制御しやすい反面、書く側の負担が大きくなりがちです。リッチテキストは見たまま編集しやすい一方、あとで差分を追うときに構造が見えにくいことがあります。マークダウンはその中間で、シンプルさを保ちながら十分な表現力を持つのが強みです。
まず覚えるべき基本の書き方
ここでは、最初の一歩でつまずきにくい順に整理します。見出し、段落、リスト、改行の4つを押さえるだけで、かなり実用的になります。
見出しと段落の作り方
見出しは、文書の骨組みを作る要素です。先頭に記号を置いて階層を示すだけで、読む側は「どこに何があるか」をすぐに把握できます。段落は、行を詰めすぎず、意味のまとまりごとに分けるのが基本です。
## 大見出し
### 小見出し
段落は、ひとまとまりごとに空行で分けます。
次の文も別の段落として読めます。箇条書きと番号付きリスト
箇条書きは、特徴や注意点を並べるときに便利です。番号付きリストは、手順や順番が大事な説明に向いています。GitHub Docsでも、リストやタスクリストはMarkdownの基本機能として案内されています。
- ひとつめ
- ふたつめ
- みっつめ
1. 手順1
2. 手順2
3. 手順3改行で失敗しないコツ
改行は「見た目の改行」と「段落の区切り」が別物です。思ったところで改行されないときは、空行が足りているかを確認すると解決しやすくなります。複数行の扱いは実装差が出やすいので、CommonMarkの考え方を基準にすると迷いにくいです。
よく使う記法を一覧で確認する
実務で使う頻度が高いのは、強調、リンク、コード、表、チェックボックスです。まずは「よく出るもの」から覚えたほうが、文章全体の見通しがよくなります。
太字・斜体・打ち消し線・コード
強調は、重要語を拾いやすくするために使います。コードは、記号や命令文をそのまま見せたいときに便利です。CommonMarkでは、コードブロックはバッククォート3つ、または4スペースのインデントで表せます。
**太字**
*斜体*
~~打ち消し線~~
`inline code`
```text
コードブロック
```リンク・画像・引用
リンクは、関連情報へ自然に誘導するための基本要素です。引用は、ほかの説明や出典をひとまとめに見せたいときに役立ちます。GitHub Docsでは、標準URLの自動リンクやリンクの作り方も案内されています。
[表示テキスト](https://example.com)
> これは引用です表・チェックボックス
表は比較や一覧に強く、チェックボックスは進捗確認やToDo整理に向いています。GitHub Docsでは表の作成方法がまとまっており、タスクリストは - [ ] と - [x] で表現できます。
| 項目 | 内容 |
|---|---|
| 見出し | 文の構造 |
| 表 | 比較しやすい |
- [ ] 未完了
- [x] 完了差し込みで迷いやすいエスケープ記号
記号そのものを表示したいときは、エスケープを使います。たとえば、見出し記号や箇条書き記号を文字として見せたい場面では、1文字ずらして書く発想が必要です。ここを覚えると、表やコードの崩れをかなり減らせます。
つまずきやすいポイントを先に潰す
マークダウンは単純に見えて、空白や改行の扱いで結果が変わります。初心者が迷いやすいのは、記号そのものより「どこで効くのか」が見えにくい点です。
スペースと改行のルール
リストや見出しは、前後の空白や行の切れ目が効いてきます。とくに複数行にわたる文では、見た目の整形より、文としてどう区切られるかを意識したほうが安定します。
半角記号の扱い
マークダウンは記号ベースなので、半角の #、*、-、[] が意味を持ちます。別の用途で使いたいときは、記号の役割を一度外す必要があります。ここを雑に扱うと、思わぬ変換崩れが起きます。
CommonMarkと拡張記法の考え方
CommonMarkは、解釈のぶれを減らすための基準です。一方で、表やタスクリストのような便利機能は、GitHub Flavored Markdownのような拡張で広がっています。つまり、まず共通部分を覚え、そのあとで使う環境の拡張を足すのがいちばん安全です。
用途別にどう使い分けるか
同じマークダウンでも、用途が変わると最適な書き方は少し変わります。README、議事録、ブログ下書きでは、見出しの深さや表の使い方が違ってきます。
| 用途 | 向いている書き方 | 相性がよい理由 |
|---|---|---|
| README | 見出し・箇条書き・コード | 導入と使い方を短く伝えやすい |
| 議事録 | 見出し・番号付きリスト・チェックボックス | 決定事項と未完了事項を分けやすい |
| ブログ下書き | 見出し・リンク・表・引用 | 本文の流れと比較情報を整理しやすい |
この表で大事なのは、「何を最初に覚えるか」が用途で変わることです。READMEならコード、議事録ならチェックボックス、ブログなら見出しと表を優先すると、学習効率が上がります。
READMEや開発メモでの使い方
技術系の文章では、コードブロックとリンクが特に重要です。GitHub DocsがMarkdownを採用しているのは、コードと説明を同じ文書で扱いやすいからです。
議事録やナレッジ共有での使い方
会議メモや社内共有では、チェックボックス、箇条書き、見出しの3点が強いです。NotePMやDocBase、GROWIのような環境がMarkdownを案内しているのも、情報整理との相性がよいからです。
ブログ本文との相性
ブログでは、見出しの階層を整えるほど読みやすくなります。表や引用を入れると、要点が一目で伝わるので、本文の密度が上がっても読み手が迷いにくくなります。
用途別の覚える順番
最初は、見出し・箇条書き・リンク・表の順で十分です。次に、コード、チェックボックス、引用を足すと、ほとんどの場面で困りません。
Markdownエディタの選び方
エディタ選びで見るべきなのは、見た目のおしゃれさより、プレビュー、表の扱いやすさ、タスクリストの使いやすさです。用途が決まっていれば、必要な機能は自然に絞れます。
まず見るべき比較軸
確認したいのは、入力しやすさ、表示の安定性、共同編集のしやすさ、そしてMarkdownの拡張機能です。表やチェックボックスをよく使うなら、その機能が標準で扱いやすいかを先に見ます。
初心者が選ぶときの基準
最初の1本は、学習コストが低いものが向いています。プレビューがすぐ見えて、見出し・リスト・表を試しやすい環境なら、文法の感覚がつかみやすくなります。
迷ったときのおすすめ判断基準
どれを選ぶか迷うなら、「自分がいちばん使う場所」で決めるのが近道です。GitHub中心ならGitHub Docsの流れ、社内共有中心ならNotePMやDocBaseの流れ、ナレッジベース中心ならGROWIの流れが参考になります。
よくある質問
MarkdownとHTMLは、どちらを先に覚えるべきですか？
まずはMarkdownで十分です。文書の骨組みを素早く書けるので、見出しやリスト、リンクの考え方を先に身につけると、必要になったときにHTMLへ移りやすくなります。
表とチェックボックスは、どの環境でも同じように使えますか？
基本は似ていますが、完全に同じとは限りません。GitHubでは表やタスクリストが案内されており、拡張記法の扱いは環境ごとに少し変わることがあります。使う場所のドキュメントを一度確認するのが安全です。
最初に覚えるなら、何から始めるのがいいですか？
見出し、箇条書き、リンク、表の4つから始めるのが実用的です。これだけでメモ、手順書、ブログ下書きの土台がかなり作れます。
まとめ
マークダウンは、見出し・リスト・リンク・表を少ない記号で扱える、実務向きの書き方です。まずは「構造を先に書く」感覚をつかむだけで、メモも文書もかなり整理しやすくなります。
今日やることはシンプルです。3行のメモを、見出しつきの短い文章に直し、そこへ箇条書きとリンクを1つ足してみてください。慣れてきたら表とチェックボックスを加えると、かなり使えるMarkdownになります。
まずは手元のメモで、見出し・箇条書き・リンク・表 の4点だけを試すところから始めると、いちばん早く定着します。
