最近、ChatGPTやClaudeといった生成AIで「スキルファイル」や指示書としてマークダウン（Markdown）形式のファイルが使われる場面が増えてきました。
Claudeの「スキル」やAIへの指示書（プロンプト）など、AIに渡すファイルの多くがマークダウン形式で書かれているためです。
ただ、普段慣れていない人は「日本語部分は記号部分が何を意味しているのかいまいち理解していない」という方も多いのではないでしょうか。
本記事では、マークダウンの基本的な書き方を初心者向けにわかりやすく解説します。
あわせて、AI関連のファイルでよく登場する「YAMLフロントマター(下記画像の---で囲んだnameやdescriptionなどの冒頭に記述する概要情報部分)」についても補足でご紹介しますので、ぜひ最後までご覧ください。
新しいコンテンツや、より詳細な解説を動画やショート動画でお届けしています。日々の情報収集にお役立てください。
マークダウン（Markdown）とは？基本をわかりやすく解説
マークダウンとは、文章に簡単な記号を付けるだけで、見出しやリスト・太字などの装飾ができる軽量なテキスト記法のことです。たとえば行の先頭に # を付けると見出しに、- を付けると箇条書きになります。
特別なソフトは必要なく、メモ帳のようなテキストエディタさえあれば誰でも書けるのが大きな魅力です。マークダウンで書かれたファイルには、.md という拡張子が使われます。
マークダウンには、主に次のような特徴があります。
- テキストエディタだけで書ける（専用ソフトが不要）
- 記号がシンプルで覚えやすい
- HTMLに変換しやすい
- ファイルが軽く、バージョン管理にも向いている
マークダウンは人間にとって読みやすく、かつコンピューターにとっても構造を解釈しやすいという、両者にとって都合のよい記法です。
「マークアップ」と「マークダウン」
Webサイトを作る際に利用されるHTML(マークアップ言語）と今回ご紹介するマークダウンは名前が似ていますが、マークダウンはマークアップを簡単にした仲間のようなものです。
マークアップ（markup） は、文章に「ここは見出し」「ここはリンク」といった意味づけ（印＝mark）をするための記法の総称です。代表例がHTMLで、タグを使って構造を指定します。
<h1>見出し</h1>
<strong>太字</strong>
マークダウン（Markdown） は、そのマークアップを「もっと簡単に書けるようにしたもの」です。同じ内容を、記号だけで手軽に書けます。
# 見出し
**太字**
マークアップ … 文章に意味や構造の印を付ける記法の総称（HTMLなど）
マークダウン … マークアップを簡単な記号で書けるようにした、軽量な記法のひとつ
名前の「up」と「down」も対比になっていて、タグで細かく"盛る"のがマークアップ、記号で手軽に"そぎ落とす"のがマークダウン、とイメージすると覚えやすいです。
AIの場合は装飾などが不要で文書構造がわかれば良いのでマークダウンによる記法がよく採用されています。
マークダウンの基本的な書き方【まず覚えたい記法】
見出しの書き方
行の先頭に #（シャープ）を付けると見出しになります。# の数を増やすほど、見出しのレベルが下がっていきます。
|
1 2 3 4 5 |
# 見出し1（最も大きい） ## 見出し2 ### 見出し3 #### 見出し4 |
# と文字の間には、半角スペースを1つ入れるのが基本です。
箇条書き・番号付きリストの書き方
箇条書き（順番のないリスト）は、行の先頭に - や * を付けます。
|
1 2 3 4 |
- りんご - みかん - ぶどう |
順番のあるリスト（番号付きリスト）は、1. のように数字とピリオドを使います。
|
1 2 3 4 |
1. お湯を沸かす 2. 麺を入れる 3. 3分待つ |
行頭に半角スペースを入れて字下げすると、入れ子（ネスト）のリストも作れます。
太字・斜体（強調）の書き方
文字を強調したいときは、対象の文字を記号で囲みます。太字は **（アスタリスク2つ）、斜体は *（アスタリスク1つ）で囲むのが基本です。
|
1 2 3 |
**ここが太字になります** *ここが斜体になります* |
リンクと画像の書き方
リンクは [表示テキスト](URL) という形で書きます。
|
1 2 |
[WEBST8の公式サイト](https://webst8.com) |
画像を表示したいときは、リンクの先頭に !（エクスクラメーションマーク）を付けます。
|
1 2 |
 |
リンクと画像は記号が1つ違うだけなので、混同しないように注意しましょう。
知っておくと便利なマークダウン記法
コードの書き方
コマンド名やファイル名など、文章の途中で短いコードを示したいときは、（バッククォート）で囲みます。
|
1 2 |
ターミナルで `cd` コマンドを実行します。 |
複数行にわたるコードは、バッククォート3つ（）で上下を囲みます。これを「コードブロック」と呼びます。
|
1 2 3 4 5 |
``` npm install npm run build ``` |
引用と水平線の書き方
引用文は、行の先頭に >（不等号）を付けて表します。
|
1 2 |
> これは引用された文章です。 |
話題の区切りに使う横線（水平線）は、- を3つ以上並べて書きます。
|
1 2 |
--- |
表（テーブル）の書き方
表は、|（パイプ）で各列を区切って作ります。1行目に見出し、2行目に --- の区切り線、3行目以降にデータを書きます。
|
1 2 3 4 5 |
| 商品名 | 価格 | | --- | --- | | りんご | 100円 | | みかん | 50円 | |
これだけで、罫線付きのきれいな表が作成できます。
【補足】YAMLフロントマターとは？基本的な書き方
AIのスキルファイルやブログ記事のマークダウンを見ると、ファイルの先頭に --- で囲まれた部分があることがあります。
これが「YAMLフロントマター」です。
YAML（ヤムル）とは設定情報を書くための記法で、フロントマターは「本文の前に置くメタ情報（その文書に関する付加情報）」を意味します。
つまりYAMLフロントマターとは、本文とは別に、タイトルや日付・タグなどの情報をまとめて記述しておく領域のことです。
書き方はファイルの一番上に --- を置き、その下に「キー: 値」の形式で情報を書き、最後にもう一度 --- で閉じます。
|
1 2 3 4 5 6 7 8 9 10 11 |
--- title: マークダウンの書き方 date: 2026-01-15 tags: - マークダウン - 初心者向け draft: false --- ここからマークダウンの本文が始まります。 |
書くときには、次の点に注意しましょう。
- コロン（
:）のあとには半角スペースを入れる - 階層（入れ子）は半角スペースのインデントで表す（タブは使わない）
- 開始と終了の
---を必ずセットで書く
AIは、このフロントマター部分を読み取って、記事のタイトルや公開設定などを自動で判断します。
本文ではなく「設定欄」だと考えるとイメージしやすいでしょう。
+ (補)YAMLとマークダウンの関係
YAMLとマークダウンは、それぞれ別の記法です。マークダウンが「本文を書くための記法」であるのに対し、YAMLは「設定情報を書くための記法」です。
両者は役割が異なりますが、マークダウンファイルの先頭にYAMLフロントマターを組み合わせて使うことで、「本文」と「設定」を1つのファイルにまとめられる、という関係になっています。
まとめ
今回は、マークダウンの基本的な書き方と、補足としてYAMLフロントマターについて解説しました。マークダウンは記号を少し覚えるだけで使い始められる、とてもシンプルな記法です。
- 見出し： 行頭に
#を付ける（数でレベルが変わる） - リスト：
-で箇条書き、1.で番号付き - 強調：
**で太字、*で斜体 - リンク・画像：
[テキスト](URL)と - YAMLフロントマター：
---で囲んでタイトルや日付などの設定を記述する
まずは見出しとリストから、実際に手を動かして書いてみるのがおすすめです。慣れてくれば、AIへの指示書づくりやブログ執筆にもきっと役立つはずです。ぜひ今日からマークダウンを使ってみてください。
個別指導形式のスクールでは、自分の知りたいことをピンポイントで学習・達成でき、自分で更新もできるというメリットもあります。
教室の無料事前相談もしておりますので、まずはお気軽にご登録ください。
YouTubeチャンネル開設しました！
最大月間50万PVの当ブログをベースに、Youtube動画配信にてWordPress、ホームページ作成、ブログのことについてお役立ち情報を随時配信していきます。
ご興味ある方はぜひチャンネル登録をしていただけますと幸いです。