← Back to Home

エンジニア必見!Markdown記法 完全マスターガイド:基礎から応用まで

エンジニアや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) はこちら。

画像

画像の挿入は、リンクの記法の先頭に ! (エクスクラメーションマーク) を付けるだけです。 ![代替テキスト(alt属性)](画像のURL) の形式になります。代替テキストは画像が読み込めなかった場合や、スクリーンリーダーで読み上げられるテキストです。

![きれいな風景の写真](/images/beautiful-scenery.png)

引用 (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をさらに快適に記述するためのツールをいくつかご紹介します。

  1. Visual Studio Code (VS Code) エンジニアにとって標準エディタとも言えるVS Codeは、Markdownの記述にも最適です。標準でプレビュー機能(Ctrl + K の後に V)を搭載しており、ショートカットや拡張機能(Markdown All in One など)を入れることで爆速で記述できます。
  2. Notion メモアプリとして大人気のNotionも、Markdownのショートカットに完全対応しています。例えば - とスペースを打てばすぐにリストになるなど、Markdownの入力体験をリッチなUIで楽しめます。
  3. Obsidian / Zenn (執筆エディタ) より本格的なナレッジ管理や記事執筆には、ローカルで完結するObsidianや、技術記事プラットフォームZennのオンラインエディタなども非常に優れています。

5. まとめ:今日からMarkdownでメモを取ろう

本記事では、Markdownのメリットと代表的な記法について詳しく解説しました。 最初は記号を覚えるのが手間に感じるかもしれませんが、数日も使えば手が勝手に動くようになり、Wordでの装飾作業が煩わしく感じるはずです。

「習うより慣れろ」の世界ですので、まずは今日の日報やちょっとした自分用のメモから、Markdownを使って書いてみてください。あなたのドキュメント作成スピードが劇的に向上することをお約束します!