エンジニアやWebライターにとって、今や必須スキルと言っても過言ではない「Markdown(マークダウン)」。 プレーンテキストでサクサク書ける軽量なマークアップ言語であり、GitHubのREADMEや、Zenn、Qiita、そしてこのブログ(Next.js + MDX)の記事も全てMarkdownで書くことができます。
この記事では、「これからMarkdownを使い始めたい」という初心者の方から、「もっと便利に使いこなしたい」という中級者の方まで役立つ、Markdown記法の完全マスターガイドをお届けします。
この記事を読むことで、マウスを使わずにキーボードだけで見出しやリスト、リンクを素早く作成でき、ドキュメント作成のスピードが劇的に向上します。ぜひブックマークして、チートシートとしてご活用ください!
1. なぜMarkdownを使うべきなのか?
記法の解説に入る前に、そもそもなぜWordやリッチテキストエディタではなく、Markdownがこれほどまでに支持されているのか、その理由を3つ解説します。
① エディタや環境に依存しない(どこでも使える)
Markdownは単なるテキストデータ(.md 拡張子)です。そのため、VS CodeやVim、メモ帳などのあらゆるテキストエディタで編集可能です。特定のソフトウェアがないと開けないといったトラブルがなく、Gitなどのバージョン管理システムとの相性も抜群です。
② タイピングの手を止めずに装飾できる
「見出しを作りたいな」と思ったとき、Wordならマウスに手を伸ばしてメニューから「見出し1」を選ぶ必要があります。しかしMarkdownなら、行の先頭に # と打つだけです。キーボードから手を離す必要がないため、思考を途切れさせることなく、文章の執筆に集中できます。
③ プレーンテキストなのに読みやすい
Markdownの記法は、変換後の見た目を連想しやすいように設計されています。たとえば、リストは - や * を使い、強調は **太字** と書きます。HTMLタグでごちゃごちゃになったテキストとは異なり、Markdownのままでも十分に人間が読んで理解しやすいのが特徴です。
それでは、具体的な記法を見ていきましょう。
2. 基礎編:よく使うMarkdown記法
まずは、記事やメモを書く上で「これだけ知っていれば8割以上の用途をカバーできる」基本的な記法をご紹介します。
見出し (Headers)
行頭に半角のハッシュ記号 # を記述すると見出しになります。# の数が増えるほど、小さな見出しになります(H1からH6まで対応)。
※ # の後には 必ず半角スペース を一つ入れてください。
# H1 (最も大きな見出し・通常は記事タイトル)
## H2 (大見出し)
### H3 (中見出し)
#### H4 (小見出し)
プレビュー:
H1
H2
H3
リスト (Lists)
箇条書き(順序なしリスト)と、番号付きリスト(順序ありリスト)も簡単に作成できます。
順序なしリスト
ハイフン - 、アスタリスク * 、プラス + のいずれかに続けて半角スペースを入力します。(一般的には - がよく使われます)
- りんご
- みかん
- ポンカン (先頭にスペースを2つ、または4つ入れるとネストできます)
- バナナ
番号付きリスト
数字の後にピリオド . と半角スペースを入力します。
1. まずはお湯を沸かします。
2. 次にカップに粉を入れます。
3. お湯を注いで3分待ちます。
文字の装飾(太字・斜体・取り消し線)
文章の中で一部を強調したい場合は、記号で文字を囲みます。
これは **太字(Bold)** です。
これは *斜体(Italic)* です。
これは ~~取り消し線(Strikethrough)~~ です。
リンク (Links) と画像 (Images)
Webページへのリンクや、画像の埋め込みも非常にシンプルです。
リンク
[表示させたいテキスト](URL) の形式で書きます。
検索エンジンでおなじみの [Google](https://google.com) はこちら。
画像
画像の挿入は、リンクの記法の先頭に ! (エクスクラメーションマーク) を付けるだけです。
 の形式になります。代替テキストは画像が読み込めなかった場合や、スクリーンリーダーで読み上げられるテキストです。

引用 (Blockquotes)
他のサイトや文献から文章を引用する場合は、行頭に > と半角スペースを入力します。
> 吾輩は猫である。名前はまだ無い。
> どこで生れたかとんと見当がつかぬ。
3. エンジニア向け・応用編:コード表現と表
技術系のブログやドキュメントを書く際に必須となるのが、ソースコードの記述ツールです。
インラインコード
文章の中に短くコードや変数名を混ぜたい時は、バッククォート(`)1つで文字を囲みます。
JavaScriptで変数を作る時は `const` か `let` を使います。
コードブロック
複数行にわたるソースコードを記述する場合は、バッククォート3つ(```)でコードの上下を囲みます。
また、開始のバッククォートの直後に言語名(js, python, html など)を指定すると、多くのフォーマッターやブログサービスで色付け(シンタックスハイライト)が行われます。
function greet(name: string): string {
return `Hello, ${name}!`;
}
console.log(greet("World"));
テーブル (表)
Markdownで表を作ることも可能です。パイプ記号 | で列を区切り、ハイフン - でヘッダーとデータ行を分けます。コロン : を使うことで、左寄せ・中央揃え・右寄せの指定も可能です。
| 左寄せ (Left) | 中央揃え (Center) | 右寄せ (Right) |
| :--- | :---: | ---: |
| りんご | 100円 | 3個 |
| みかん | 50円 | 10個 |
| メロン | 1000円 | 1個 |
プレビュー:
| 左寄せ (Left) | 中央揃え (Center) | 右寄せ (Right) | | :--- | :---: | ---: | | りんご | 100円 | 3個 | | みかん | 50円 | 10個 | | メロン | 1000円 | 1個 |
4. Markdownを快適に書くためのおすすめ環境
最後に、Markdownをさらに快適に記述するためのツールをいくつかご紹介します。
- Visual Studio Code (VS Code)
エンジニアにとって標準エディタとも言えるVS Codeは、Markdownの記述にも最適です。標準でプレビュー機能(
Ctrl + Kの後にV)を搭載しており、ショートカットや拡張機能(Markdown All in One など)を入れることで爆速で記述できます。 - Notion
メモアプリとして大人気のNotionも、Markdownのショートカットに完全対応しています。例えば
-とスペースを打てばすぐにリストになるなど、Markdownの入力体験をリッチなUIで楽しめます。 - Obsidian / Zenn (執筆エディタ) より本格的なナレッジ管理や記事執筆には、ローカルで完結するObsidianや、技術記事プラットフォームZennのオンラインエディタなども非常に優れています。
5. まとめ:今日からMarkdownでメモを取ろう
本記事では、Markdownのメリットと代表的な記法について詳しく解説しました。 最初は記号を覚えるのが手間に感じるかもしれませんが、数日も使えば手が勝手に動くようになり、Wordでの装飾作業が煩わしく感じるはずです。
「習うより慣れろ」の世界ですので、まずは今日の日報やちょっとした自分用のメモから、Markdownを使って書いてみてください。あなたのドキュメント作成スピードが劇的に向上することをお約束します!