Markdownチートシート:構文、フォーマット、構造のクイックリファレンス

Markdownのクイックリファレンス:見出し、リスト、コード、テーブルなど。

目次

Markdown言語はWikipediaや Hugoで利用されています。 見出し、リスト、フォントスタイルの変更、画像、コード引用、テーブルなどのサポートに対応しています。 ここでは、Markdownのフォーマットに関する簡単なまとめを記載します。

markdown-file in the space 上記の画像は、Flux - テキストから画像への変換AIによって生成されたものです。

Markdownは、プレーンテキスト文書にフォーマット要素を追加するために使用できる軽量なマークアップ言語です。本ガイドでは、最も一般的に使用されるMarkdown構文の包括的な概要を提供し、構造化され視覚的に魅力的な文書を作成するお手伝いをします。

このチートシートは、2026年のドキュメントツール: Markdown, LaTeX, PDF & プリンティングワークフローハブの一部です。

Markdownの見出し (H1–H6)

Markdownでの見出しは、ハッシュ記号(#)を使用して作成します。見出しテキストの前にあるハッシュの数によって、見出しのレベルが決定されます。

# H1
## H2
### H3
#### H4
##### H5
###### H6

太字、斜体、および強調

Markdownでは、テキストを強調する方法がいくつか用意されています。斜体にはアスタリスク(*)またはアンダースコア(_)を、太字には二重アスタリスク(**)または二重アンダースコア(__)を使用できます。

斜体

*斜体* または _斜体_

太字

**太字** または __太字__

太字と斜体

***太字かつ斜体*** または ___太字かつ斜体___

順序付きリストと順序なしリスト

Markdownでは、順序付きリストと順序なしリストの両方をサポートしています。

順序なしリスト

- 項目 1
- 項目 2
  - サブ項目 1
  - サブ項目 2

順序付きリスト

1. 最初の項目
2. 2番目の項目
   1. サブ項目 1
   2. サブ項目 2

Markdownにおけるハイパーリンク

リンクを作成するには、リンクテキストを角括弧([])で囲み、その後、URLを丸括弧(())で囲みます。

[リンクテキスト](URL)

詳細な情報は[Markdownガイド](https://www.markdownguide.org/)をご覧ください。

画像の埋め込み

画像は、感嘆符(!)に続き、角括弧内の代替テキスト(alt text)と、丸括弧内の画像URLを使用して追加します。

![代替テキスト](画像URL)

![Markdownロゴ](https://www.markdownguide.org/assets/images/markdown-logo.png)

引用ブロックとネストされた引用

引用ブロックは、大なり記号(>)を使用して作成します。

> これは引用ブロックです。

ネストされた引用ブロック

> これは1段目の引用です。
>> これはネストされた引用ブロックです。

インラインコードとフェンス付きコードブロック

バックチック(`)で囲むことでインラインコードを追加できます。コードブロックには、コードの前後にトリプルバックチック(```)を使用します。

インラインコード

C言語でテキストを印刷するには `printf()` を使用します。

コードブロック

```python
python def hello_world(): print("Hello, World!")  
```

Markdownにおけるコードブロックについては、別の記事を参照してください: Markdownコードブロックの使用mermaid言語識別子は一つの注目すべき特殊ケースであり、シンタックスハイライトではなくダイアグラムのレンダリングをトリガーし、プレーンなフェンスブロックをフローチャートやシーケンスダイアグラムに変換します。Mermaidダイアグラムクイックスタートでは、フローチャートからER図に至るまでの完全なダイアグラム構文が解説されています。

水平線(区切り線)

水平線は、3つ以上のダッシュ(—)、アスタリスク(***)、またはアンダースコア(___)を使用して作成します。

---

テーブル

Markdownでのテーブルは、パイプ(|)とハイフン(-)を使用して作成します。

| ヘッダー 1 | ヘッダー 2 |
|----------|----------|
| セル 1   | セル 2   |
| セル 3   | セル 4   |

配置オプション、マルチカラムフォーマット、およびGFM固有の機能については、Markdownでのテーブル: 完全ガイドを参照してください。

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

タスクリストは、チェックボックスを作成できる特殊なリストタイプです。

- [x] 完了したタスク
- [ ] 未完了のタスク

取り消し線テキスト

取り消し線テキストは、二重チルダ(~~)を使用して作成します。

~~これは取り消し線テキストです。~~

テキストのハイライト

テキストのハイライトはMarkdownでネイティブにはサポートされていませんが、一部のレンダラーは==構文を使用してサポートしています。

==これはハイライトされたテキストです。==

下付き文字と上付き文字

下付き文字はテキストの前にキャレット(^)を使用して作成し、上付き文字はテキストの前にチルダ(~)を使用して作成します。

H~2~O は水です。
E = mc^2

数式(LaTeX構文)

数式は、ドル記号($)内のLaTeX構文を使用して追加できます。

$$ E = mc^2 $$

特殊文字のエスケープ

特殊文字をエスケープするには、バックスラッシュ(\)を使用します。

\*斜体\* または \_斜体\_

この包括的なチートシートでは、フォーマットされた文書を作成するために必要な基本的なMarkdown構文を網羅しています。より高度な機能やカスタマイズについては、特定のレンダラーのドキュメントや追加リソースを参照してください。Hugoをお使いの場合は、Hugoコマンドチートシートが便利な参考資料となります。

Markdownはまた、セルフホスティング型のWikiやナレッジシステムにおけるデフォルトのストレージフォーマットでもあります。DokuWikiは、個人やチームのナレッジベースのために、Markdownフレンドリーなプレーンテキストアプローチを採用しています。Markdownページに構築されたAI支援ナレッジシステムについては、LLM Wikiで、このフォーマットのポータビリティとdiffability(差分追跡の容易さ)がコンパイル済みナレッジの適切な基盤となる理由について説明しています。

購読する

システム、インフラ、AIエンジニアリングの新記事をお届けします。