PR

Markdown完全入門ガイド|書き方・記法一覧・おすすめエディタまで徹底解説

スポンサーリンク
スポンサーリンク

最終更新日:2026年04月29日

「Markdownって何?」「記法の書き方がよくわからない」「どのエディタを使えばいいの?」——そんな疑問を持つ方に向け、本記事ではMarkdownの基礎知識・記法一覧・おすすめエディタ・HTML変換方法・実践活用術をまとめて解説します。初心者でも今日から書き始められるよう、具体的なコード例を交えながらわかりやすく説明していきます。

  1. Markdownとは?初心者向けにわかりやすく解説
    1. Markdownが生まれた背景と目的
    2. HTMLとの違いと関係性(CommonMark・GFMについても一言補足)
  2. Markdown記法一覧:基本の書き方を完全マスター
    1. 見出し・段落・改行の書き方
    2. 強調(太字・斜体)・取り消し線
    3. リスト(箇条書き・番号付き)の書き方
    4. リンク・画像の挿入方法
    5. コードブロック・インラインコードの書き方
    6. 引用・水平線・テーブルの書き方
    7. Markdown記法クイックリファレンス(一覧表)
  3. Markdownのおすすめエディタ6選【無料〜有料まで比較】
    1. 無料で使えるおすすめエディタ3選(VSCode・Obsidian・Zettlr)
    2. 有料・高機能エディタの紹介(Typora等)
    3. インストール不要のオンラインエディタ(ブラウザで今すぐ試せる)
  4. MarkdownをHTMLに変換する方法
    1. オンライン変換ツールの使い方(手順をステップ解説)
    2. 主要CMSでのMarkdown対応状況まとめ(WordPress・Notion・はてなブログ等)
  5. 用途別・Markdownの実践的な使い方ガイド
    1. メモ・ノート管理での活用(Notion・Obsidian)
    2. GitHubでのREADME・Issue記述でのMarkdown活用術
    3. ブログ・技術記事執筆(Qiita・Zenn等)でのMarkdown活用
  6. Markdownでよくある書き方ミスと解決策
    1. 改行・空行が反映されない原因と対処法
    2. 特殊文字・記号が意図せず変換されるときのエスケープ処理
  7. Markdownに関するよくある質問(FAQ)
    1. Markdownファイルはどのファイル形式で保存しますか?
    2. WordやGoogleドキュメントでMarkdownは使えますか?
    3. CommonMarkとGitHub Flavored Markdown(GFM)の違いは何ですか?
    4. Markdownで数式を書くにはどうすればいいですか?
    5. Markdownを学ぶのにかかる時間はどれくらいですか?
  8. まとめ:Markdownをマスターして文書作成を効率化しよう

Markdownとは?初心者向けにわかりやすく解説

Markdownとは、シンプルなテキスト記法で文書の構造(見出し・リスト・強調など)を表現できる軽量マークアップ言語です。記述したテキストはHTMLやPDFなどに変換でき、Notion・GitHub・Qiitaといった主要サービスでネイティブ対応しています。難しいタグを覚えなくてよいため、エンジニアのみならずビジネスパーソン・ライター・学生など幅広い層に使われています。

Markdownが生まれた背景と目的

Markdownは2004年、John Gruber氏によって設計されました。設計の目標は「人間が読みやすく書きやすい形式で記述しながら、そのままHTMLへ変換できること」です。メールやネット掲示板で自然発生的に使われてきた慣習的な書き方——アスタリスクで囲む強調、ハイフンで始まるリストなど——をベースにしているため、記法を知らなくても直感的に読みやすい設計になっています。

HTMLとの違いと関係性(CommonMark・GFMについても一言補足)

HTMLは「ブラウザに表示方法を命令するタグ言語」です。一方Markdownは「人間が読みやすいプレーンテキスト記法」であり、ツールがMarkdownをHTMLへ自動変換します。つまりMarkdownはHTMLの代替ではなく、HTMLをより手軽に書くための入力方法です。

Markdownには複数の「方言」があります。CommonMarkは仕様を厳密に標準化したもの、GitHub Flavored Markdown(GFM)はGitHubが独自拡張を加えたもので、チェックリスト・テーブル・取り消し線などが追加されています。利用するサービスがどの方言に対応しているか確認しておくと、意図しない表示崩れを防げます。

Markdown記法一覧:基本の書き方を完全マスター

Markdownで覚えるべき記法は限られており、習得のハードルは非常に低いです。以下では頻繁に使う記法を分類して解説します。最後のクイックリファレンス表も活用すれば、必要な書き方をすぐ確認できます。

見出し・段落・改行の書き方

見出しは行頭に#を付けて記述します。#の数が多いほど階層が深くなります(H1〜H6まで対応)。

  • # 見出し1(H1)
  • ## 見出し2(H2)
  • ### 見出し3(H3)

段落は空行(Enterキー2回)で区切ります。単純な改行(Enterキー1回)だけでは段落が分かれない場合が多いため注意してください。段落内で強制改行したい場合は、行末にスペースを2つ入れるか、バックスラッシュ(\)を記述します。

強調(太字・斜体)・取り消し線

文字の強調には以下の記法を使います。組み合わせて太字+斜体にすることも可能です。

  • 太字:**テキスト**または__テキスト__
  • 斜体:*テキスト*または_テキスト_
  • 取り消し線(GFM拡張):~~テキスト~~
  • 太字+斜体:***テキスト***

取り消し線はCommonMarkの標準仕様には含まれませんが、GitHub・Notion・Zennなど主要サービスで利用できます。

リスト(箇条書き・番号付き)の書き方

リストは順序のない箇条書きリストと、順番に意味がある番号付きリストの2種類があります。

  • 箇条書き:-*+のいずれかを行頭に付ける
  • 番号付き:1.(数字+ピリオド)を行頭に付ける
  • ネスト(入れ子):子要素にスペース2〜4つのインデントを加える

番号付きリストの数字は実際の値に関わらずレンダリング時に自動連番が振られます。管理のしやすさからすべて1.と書く書き方も一般的です。

リンク・画像の挿入方法

リンクと画像の記法は非常に似ています。画像はリンクの先頭に!を付けた形です。

  • リンク:[表示テキスト](URL)
  • タイトル付きリンク:[テキスト](URL "タイトル")
  • 画像:![代替テキスト](画像URL)
  • 参照形式:[テキスト][id](別途[id]: URLを定義)

画像のalt(代替テキスト)はアクセシビリティとSEOの両面から必ず記述しましょう。空欄(![](URL))にするとスクリーンリーダーが内容を読み上げられなくなります。

コードブロック・インラインコードの書き方

プログラムコードや技術的な文字列を明示するために使います。技術系ブログやGitHubのREADMEで特に重要な記法です。

  • インラインコード:バックティック(`)1つで囲む → `コード`
  • コードブロック:バックティック3つ(```)で前後を囲む
  • シンタックスハイライト:開始の```直後に言語名を指定(例:```python```javascript

言語名を指定すると対応ビューアでカラーハイライトが適用され、コードの可読性が大幅に向上します。省略しても動作しますが、指定する習慣を付けておくのがおすすめです。

引用・水平線・テーブルの書き方

引用・水平線・テーブルもMarkdownで簡単に表現できます。

  • 引用:行頭に>を付ける(ネスト:>>
  • 水平線:---または***を単独行に記述
  • テーブル(GFM拡張):|(パイプ)で列を区切り、2行目に| --- |を設ける

テーブルの寄せ位置は:---(左寄せ)・:---:(中央)・---:(右寄せ)で指定できます。比較表を作るときに便利です。

Markdown記法クイックリファレンス(一覧表)

よく使う記法を一覧にまとめました。書き方を忘れたときの参照用にブックマークしておくと便利です。

要素 Markdown記法 備考
見出し # 〜 ###### #の数で階層を指定
太字 **テキスト** アスタリスク2つで囲む
斜体 *テキスト* アスタリスク1つで囲む
取り消し線 ~~テキスト~~ GFM拡張
箇条書き - 項目 -・*・+いずれか
番号付きリスト 1. 項目 連番は自動付与
リンク [テキスト](URL)
画像 ![alt](URL) !を先頭に付ける
インラインコード `コード` バックティック1つ
コードブロック ```言語名 前後にバックティック3つ
引用 > テキスト ネスト可
水平線 --- 3つ以上のハイフン
テーブル | col | col | GFM拡張

Markdownのおすすめエディタ6選【無料〜有料まで比較】

Markdownを快適に書くには、対応エディタの選択が重要です。自分の用途・環境に合ったエディタを選ぶことで作業効率が大きく変わります。無料・有料・オンラインの3カテゴリに分けてご紹介します。

無料で使えるおすすめエディタ3選(VSCode・Obsidian・Zettlr)

コストをかけずに高機能なMarkdown環境を整えたい方には、以下の3つが特におすすめです。

  • Visual Studio Code(VSCode):Microsoftが提供する無料コードエディタ。Markdownプレビュー機能が標準搭載されており、拡張機能「Markdown All in One」を追加するとさらに快適になります。プログラミングと文書作成を一つのツールで完結したい方に最適です。
  • Obsidian:ローカルファイルベースのノート管理ツール。Markdownファイルを双方向リンクで繋いでナレッジベースを構築できます。個人利用は無料。データをクラウドに預けたくない方・プライバシーを重視する方に向いています。
  • Zettlr:研究者・ライター向けのオープンソースMarkdownエディタ。Zoteroなどの文献管理ツールとの連携機能が充実しており、学術論文や長文執筆に強みがあります。

有料・高機能エディタの紹介(Typora等)

WYSIWYG(見たままの表示)によるスムーズな編集体験にこだわるなら、有料エディタも検討する価値があります。

  • Typora:記法を入力すると即座にリアルタイムレンダリングされ、プレビューウィンドウの行き来が一切不要です。買い切り型(約$14.99)でWindows・Mac・Linux対応。「書いた結果をすぐ確認しながら執筆したい」方に特におすすめです。

有料エディタは購入前に無料トライアル期間を設けているものが多いため、実際に試してから判断することをおすすめします。

インストール不要のオンラインエディタ(ブラウザで今すぐ試せる)

「まずMarkdownを体験してみたい」「インストールなしですぐ使いたい」という方にはオンラインエディタが最適です。

  • Dillinger:左側にMarkdownを入力すると右側にリアルタイムHTMLプレビューが表示されます。GitHub・Dropboxとの連携やPDF・HTML形式でのエクスポートにも対応しており、機能性と使いやすさのバランスが優れています。
  • StackEdit:ブラウザベースながら豊富な機能を備えたMarkdownエディタ。オフライン動作・Google Drive連携・ブログへの直接投稿など多機能なのが魅力です。

MarkdownをHTMLに変換する方法

Markdownで書いた文書をWebに公開したりCMSに貼り付けたりする際、HTMLへの変換が必要になる場面があります。オンラインツールを使う方法CMS側のMarkdown対応機能を活用する方法の2つを押さえておきましょう。

オンライン変換ツールの使い方(手順をステップ解説)

最も手軽な変換方法は、前述のDillingerを使うことです。手順は以下のとおりです。

  1. Dillingerにアクセスする
  2. 左側のパネルにMarkdown文書を貼り付ける
  3. 画面上部の「Export As」メニューをクリックする
  4. 「HTML」を選択してダウンロードする

より高度な変換(複数フォーマット対応・コマンドライン操作)にはPandocが強力な選択肢です。MarkdownからHTML・PDF・Word・EPUBなど多彩な形式に変換でき、コマンド1行で処理できます。定期的に変換作業が発生する方におすすめです。

主要CMSでのMarkdown対応状況まとめ(WordPress・Notion・はてなブログ等)

現在、多くのCMSやブログサービスがMarkdownに対応しています。自分が使うプラットフォームの対応状況を事前に確認しておきましょう。

サービス Markdown対応 備考
Notion ◎ネイティブ対応 入力するとリアルタイムレンダリング
GitHub ◎GFM対応 README・Issue・PRすべてで利用可
WordPress △プラグイン必要 「WP Githuber MD」等で対応
はてなブログ ○設定で有効化 編集モードをMarkdownに切替可能
Qiita / Zenn ◎ネイティブ対応 GFM拡張+独自拡張あり

用途別・Markdownの実践的な使い方ガイド

Markdownの記法を覚えたら、次は実際の場面で活用してみましょう。「メモ・ノート管理」「GitHub」「ブログ・技術記事」の3つのシーンで役立つ使い方をご紹介します。

メモ・ノート管理での活用(Notion・Obsidian)

NotionとObsidianはいずれもMarkdownをベースとしたノートアプリで、日々のメモ・プロジェクト管理・アイデア整理などに使われています。

Notionでは、見出し・チェックリスト・テーブル・コールアウトをMarkdown記法(または/コマンド)で素早く入力でき、ドキュメントを整理しながらチームで共有できます。Obsidianはデータをローカルに保管するため、プライバシーを重視したい個人ユーザーや、ネット接続に左右されずに使いたい方に特に向いています。

GitHubでのREADME・Issue記述でのMarkdown活用術

GitHubのMarkdown(GFM)はリポジトリのREADMEやIssue・Pull Requestの記述で標準的に使われています。以下のポイントを意識すると伝わりやすいドキュメントが書けます。

  • READMEにはプロジェクト概要・セットアップ手順・使い方をH2で整理する
  • コードブロックに言語名を指定してシンタックスハイライトを活用する
  • IssueではGFMのチェックリスト(- [ ] タスク)でTODO管理を行う
  • バッジ(シールド)を画像記法で埋め込み、CI/CDステータスを可視化する

ブログ・技術記事執筆(Qiita・Zenn等)でのMarkdown活用

QiitaZennはエンジニア向け技術記事プラットフォームで、Markdownがネイティブに使えます。記事の見出しをH2・H3で階層化すると目次が自動生成され、読者が情報を探しやすくなります。コードブロックと言語指定を組み合わせることでサンプルコードが見やすく表示され、記事のクオリティが一段階上がります。

Markdownでよくある書き方ミスと解決策

Markdownを使い始めた方が特につまずきやすいポイントを2つ取り上げます。「なぜか意図通りに表示されない」というときは、まずここを確認してみてください。

改行・空行が反映されない原因と対処法

Markdownでは単純な改行(Enterキー1回)は多くの場合無視されます。これが初心者が最初につまずくポイントです。

  • 段落を分けたい場合:空行(Enterキー2回)で段落を区切る
  • 段落内で改行したい場合:行末にスペースを2つ入れるか、バックスラッシュ(\)を付ける
  • コードブロック内の改行:そのまま反映されるため問題なし

エディタによって改行の扱いが異なる場合があります。使用するエディタとレンダリング先(CMSなど)の組み合わせで、実際に表示を確認する習慣をつけましょう。

特殊文字・記号が意図せず変換されるときのエスケープ処理

アスタリスク(*)・アンダースコア(_)・バックティック(`)など、Markdownの記法に使われる記号をそのまま表示させたい場合はバックスラッシュ(\)でエスケープします。

  • \* → アスタリスク記号として表示(斜体にならない)
  • \# → #記号として表示(見出しにならない)
  • \` → バックティックとして表示(コードにならない)

URLや数式にアンダースコアが多く含まれる場合、意図しないイタリックが発生することがあります。そのような箇所はインラインコード(バックティックで囲む)での記述も検討してみてください。

Markdownに関するよくある質問(FAQ)

Markdownファイルはどのファイル形式で保存しますか?

Markdownファイルは拡張子.mdまたは.markdownで保存します。内容はどちらも同じプレーンテキストですが、一般的には.mdが広く使われています。GitHubのリポジトリではREADME.mdという名前がよく使われます。

WordやGoogleドキュメントでMarkdownは使えますか?

Wordはネイティブでのmarkdown対応はありませんが、Pandocなどのツールを使ってMarkdownからWord形式(.docx)に変換できます。Googleドキュメントは2022年以降「Markdownの自動修正」機能が追加されており、Markdown記法のテキストを貼り付けると書式が適用される機能が利用できます。

CommonMarkとGitHub Flavored Markdown(GFM)の違いは何ですか?

CommonMarkはMarkdownの仕様を厳密に標準化したものです。GFM(GitHub Flavored Markdown)はCommonMarkをベースにGitHubが独自拡張を加えた仕様で、テーブル・タスクリスト(チェックボックス)・取り消し線・URLの自動リンク化などが追加されています。GitHubやNotionなど多くのサービスがGFMを採用しているため、GFMを基準に覚えておくと応用が効きます。

Markdownで数式を書くにはどうすればいいですか?

Markdownの標準仕様には数式記法は含まれませんが、多くのサービスがKaTeXまたはMathJaxを利用した数式レンダリングをサポートしています。インライン数式は$E=mc^2$、ブロック数式は$$(数式)$$でTeX記法を囲む形式が一般的です。GitHub・Notion・Zenn・JupyterなどでKaTeX/MathJaxが利用できます。

Markdownを学ぶのにかかる時間はどれくらいですか?

基本的な記法(見出し・リスト・太字・リンク・コード)は30分〜1時間あれば習得できます。使いながら覚えていくスタイルが最も効率的です。テーブルや拡張記法を含めた実務レベルの習熟には1〜2週間程度の継続利用が目安です。まずはこの記事のクイックリファレンス表を手元に置いて書いてみることをおすすめします。

まとめ:Markdownをマスターして文書作成を効率化しよう

この記事では、Markdownの基礎からおすすめエディタ・HTML変換・実践活用術・よくあるミスの解決策まで幅広く解説しました。要点を整理します。

  • Markdownはシンプルなテキスト記法で書式を表現できる軽量マークアップ言語
  • 基本記法(見出し・太字・リスト・リンク・コード)を覚えるだけで大半のシーンに対応できる
  • 用途に合わせてVSCode(無料・汎用)・Obsidian(ノート管理)・Typora(WYSIWYG)などを選ぼう
  • Notion・GitHub・Qiita・Zennなど主要サービスはMarkdownをネイティブサポートしている
  • 改行・エスケープのミスを知っておくだけで、つまずきを大幅に減らせる

Markdownは「覚えること自体」よりも「使いながら慣れること」が上達の近道です。この記事のクイックリファレンス表をブックマークして、今日から実際のメモ・ドキュメント作成に取り入れてみてください。

本記事の著者は日々の業務でMarkdownを活用しており、エンジニアからライター・学生まで幅広い読者の方にMarkdownの便利さを伝えることを目指して情報発信を続けています。

タイトルとURLをコピーしました