Markdownの記述方法を初心者向けに解説|見出し・リスト・リンクの書き方

Markdown(マークダウン)とは?

Markdown(マークダウン)は、シンプルな記号だけで見出し・太字・リスト・リンクなどを書ける軽量マークアップ言語です。

この記事では初心者向けに基本文法をすべて網羅し、実際に使えるMarkdown例と「コピペボタン」を用意しました。

Markdown(マークダウン)は何で使える?

Markdownは、プレーンテキストのまま書ける手軽さと、HTMLへの変換のしやすさから、さまざまな場面で活用されています。ここでは主な利用シーンを紹介します。

ドキュメント・README

GitHubやGitLabのREADME.md、技術ドキュメント、仕様書などに広く使われます。コードと一緒に説明を書くのに便利です。

ブログ・静的サイト

Jekyll、Hugo、Astroなどの静的サイトジェネレーター、はてなブログ、Qiita、Zennなどで記事を書くときに使います。

ノート・知識管理

Obsidian、Notion、Logseq、Roam Researchなどのノートアプリで、階層的なメモやリンクを簡単に作れます。

チャット・コミュニティ

Discord、Slack、Reddit、一部のフォーラムで、太字・リスト・コードブロックなどを手軽に入力できます。

プレゼン・スライド

MarpやReveal.jsなどで、Markdownからスライドを生成できます。

電子書籍・PDF変換

Pandocなどを使って、MarkdownからPDF、Word、EPUBなどに変換できます。

メールやその他

一部のメールクライアントやWikiでもサポートされています。

このようにMarkdownは、技術者だけでなくライターや一般ユーザーにも広く使われる便利な記法です。まずは簡単なリストや見出しから試してみてください。

見出し(Headings)

行の先頭に # を付けます。数が増えるほど小さい見出しになります(h1〜h6)。

Markdown

# 見出し1(最も大きい)
## 見出し2
### 見出し3
#### 見出し4
##### 見出し5
###### 見出し6

強調(太字・斜体・打ち消し線)

アスタリスク(*)やアンダースコア(_)で囲みます。

Markdown

**太字** または __太字__
*斜体* または _斜体_
***太字かつ斜体***
~~打ち消し線~~

表示結果
太字 または 太字
斜体 または 斜体
太字かつ斜体
打ち消し線

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

箇条書き(順序なし)

Markdown

- りんご
- バナナ
  - 完熟バナナ
  - 青バナナ
- みかん

* アスタリスクでもOK
+ プラスでもOK

表示結果
  • りんご
  • バナナ
    • 完熟バナナ
    • 青バナナ
  • みかん

番号付きリスト

Markdown

1. まず準備する
2. 次に実行する
3. 最後に確認する

表示結果
  1. まず準備する
  2. 次に実行する
  3. 最後に確認する

Markdown

[表示テキスト](https://example.com)
[表示テキスト](https://example.com "ツールチップ")

<https://example.com>  ← URLをそのままリンクにする

表示結果

画像

リンクの先頭に ! を付けます。

Markdown

![代替テキスト](画像のURL)
![ロゴ](https://example.com/logo.png "画像のタイトル")

ポイント
代替テキストは画像が表示されないときに代わりに表示されます。SEOやアクセシビリティのためにも必ず書きましょう。

コード(インライン・ブロック)

インラインコード

Markdown

変数 `name` に値を代入します。

表示結果
変数 name に値を代入します。

コードブロック

Markdown

```javascript
function hello(name) {
  console.log("Hello, " + name);
}
```

表示結果
function hello(name) {
  console.log("Hello, " + name);
}

引用(Blockquote)

Markdown

> これは引用文です。
> 複数行も書けます。
>
> > 入れ子の引用も可能です。

表示結果

これは引用文です。
複数行も書けます。

入れ子の引用も可能です。

水平線

Markdown

---

または ***___ でも同じです。

表(テーブル)

GitHub Flavored Markdown(GFM)で利用できます。WordPressの多くのエディタでも対応しています。

Markdown

| 名前     | 年齢 | 出身地   |
|----------|------|----------|
| 田中     | 28   | 東京     |
| 鈴木     | 34   | 大阪     |
| 佐藤     | 22   | 福岡     |

表示結果
名前 年齢 出身地
田中 28 東京
鈴木 34 大阪
佐藤 22 福岡

右寄せ・中央揃えも可能です:

| 左寄せ | 中央揃え | 右寄せ |
|:-------|:--------:|-------:|
| 左     | 中央     | 右     |

タスクリスト(チェックボックス)

Markdown

- [x] 完了したタスク
- [ ] 未完了のタスク
- [ ] もう一つのタスク

表示結果
  • 完了したタスク
  • 未完了のタスク
  • もう一つのタスク

エスケープ(記号をそのまま表示)

Markdownの記号を文字として表示したいときは、バックスラッシュ(\)を前に付けます。

Markdown

\*これは斜体になりません\*
\# これは見出しになりません

表示結果
*これは斜体になりません*
# これは見出しになりません

まとめ

Markdownの基本は「記号を少し覚えるだけ」です。

見出し・強調・リスト・リンク・コードさえ覚えれば快適に書けるようになります。

この記事のコード例はすべてコピペ可能です。

ぜひ実際に試してみて、Markdownの書きやすさを体感してください。

わたし

夜の闇に紛れて、静かに息を潜める存在。私は、言葉の影に隠れた物語を紡ぐ者。月明かりの下、ページをめくる指先に感じるのは、未知の世界への誘い。読書と音楽が、孤独な夜を彩る唯一の灯火。どこか遠くの街で、誰かの物語が始まるのを待っている。静かな夜の時間の中で、言葉の響きに耳を澄ますのが好きだ。風の便りに乗って届く、遠くの街の噂話や、古い本のページに残された、忘れられた物語に心惹かれる。物語の世界に没頭する時、現実の境目は曖昧になる。現実と虚構の狭間で、自分の心の声に耳を傾ける。そうすることで、言葉の奥深くに隠された、真実の一端に触れることができるような気がする。音楽もまた、言葉と同じく、私の心を揺さぶる。メロディーの波に乗って、遠くの記憶や、忘れていた感情が蘇ることがある。夜の静寂の中で響く音楽は、孤独な心を慰めてくれる。私の日常は、静かな時間が流れる。読書と音楽に囲まれ、言葉の響きに耳を澄ます。そんな中で、私は自分の心の声に耳を傾け、物語を紡いでいる。どこか遠くの街で、誰かの物語が始まるのを待っている。わたしという名前の背後には、様々な物語が隠されている。言葉の影に隠れた、私の物語に興味を持ってくれる人がいれば、嬉しい。

わたしをフォローする
おすすめ
シェアする
わたしをフォローする
タイトルとURLをコピーしました