Markdown構文クイックリファレンス:初心者から上級者まで

はじめに

Markdownは軽量なマークアップ言語で、読みやすく書きやすいプレーンテキスト形式で文書を作成できます。このクイックリファレンスは、基本から上級までのすべてのMarkdown構文を網羅し、実用的な例を提供しています。Markdown初心者であっても、特定の構文を確認したい場合であっても、このガイドがお役に立ちます。

基本構文

見出し(Headings)

Markdownは6レベルの見出しをサポートし、#記号で表現します:

# レベル1見出し
## レベル2見出し
### レベル3見出し
#### レベル4見出し
##### レベル5見出し
###### レベル6見出し

アンダーライン形式も使用できます(レベル1とレベル2のみ):

レベル1見出し
========

レベル2見出し
--------

段落と改行

段落の間は空行で区切ります。新しい段落を始めずに改行したい場合は、行末に2つのスペースを追加します。

これは第一段落です。

これは第二段落です。

これは一行目です  
これは次の行です(上の行の末尾の2つのスペースに注意)

テキスト書式

効果 構文
太字 **テキスト** または __テキスト__ 太字テキスト
斜体 *テキスト* または _テキスト_ 斜体テキスト
太字斜体 ***テキスト*** または ___テキスト___ 太字斜体テキスト
取り消し線 ~~テキスト~~ 取り消し線テキスト
下線 <u>テキスト</u> 下線テキスト

リスト

順序なしリスト

-+または*で順序なしリストを作成します:

- 項目一
- 項目二
  - サブ項目 2.1
  - サブ項目 2.2
- 項目三

+ プラス記号も使用可能
* アスタリスクも使用可能

順序付きリスト

数字とドットで順序付きリストを作成します:

1. 第一項目
2. 第二項目
   1. サブ項目 2.1
   2. サブ項目 2.2
3. 第三項目

タスクリスト

GitHubスタイルのタスクリスト:

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

リンク

インラインリンク

[リンクテキスト](https://www.example.com)
[タイトル付きリンク](https://www.example.com "リンクタイトル")

参照リンク

[リンクテキスト][参照ラベル]

[参照ラベル]: https://www.example.com "オプションタイトル"

自動リンク

<https://www.example.com>
<[email protected]>

画像

![代替テキスト](画像URL)
![タイトル付き画像](画像URL "画像タイトル")

参照式画像:
![代替テキスト][画像参照]

[画像参照]: 画像URL "オプションタイトル"

引用

> これは引用です
> 複数行にできます
> 
> > ネストした引用も可能です

コード

インラインコード

`バッククォート`で囲んでインラインコードを表現

コードブロック

3つのバッククォートまたは4つのスペースでインデントを使用します:

```javascript
function hello() {
    console.log("Hello, World!");
}
```

    またはインデントを使用(4つのスペース)
    function hello() {
        console.log("Hello, World!");
    }

区切り線

3つ以上のハイフン、アスタリスク、またはアンダースコアを使用します:

---
***
___

上級構文

| 列1 | 列2 | 列3 |
|-----|-----|-----|
| データ1 | データ2 | データ3 |
| データ4 | データ5 | データ6 |

アライメント方法:
| 左寄せ | 中央 | 右寄せ |
|:-------|:----:|-------:|
| 左 | 中 | 右 |

脚注

これは脚注の例です[^1]。

[^1]: これは脚注の内容です。

定義リスト

用語1
: 定義1

用語2
: 定義2a
: 定義2b

略語

HTMLはハイパーテキストマークアップ言語です。

*[HTML]: Hyper Text Markup Language

GitHubフレーバーMarkdown(GFM)

シンタックスハイライト

コードブロックで言語を指定:

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

```json
{
  "name": "example",
  "version": "1.1.0"
}
```

絵文字

:smile: :heart: :thumbsup: :star:

ユーザーメンションとイシュー参照

@ユーザー名
#123 (イシュー番号)
組織/リポジトリ#123

HTMLサポート

MarkdownはインラインHTMLをサポート:

<div style="color: red;">
  これは赤いテキストです
</div>

<details>
  <summary>クリックして展開</summary>
  非表示のコンテンツ
</details>

エスケープ文字

バックスラッシュで特殊文字をエスケープ:

\* 斜体ではありません
\# タイトルではありません
\[リンクではありません\]

エスケープが必要な文字:

\ ` * _ {} [] () # + - . ! |

ベストプラクティス

1. 一貫性を保つ

  • タイトルスタイルを選んで一貫して使用
  • リストマーカーとして*または-を統一して使用
  • インデントを一定に保つ(通券2または4スペース)

2. 可読性を優先

  • タイトルの前後に空行を追加
  • 段落間は空行で区切る
  • 過度に長い行を避ける(推奦80-100文字)

3. セマンティックな使用

  • タイトルは階層に従って使用し、レベルを飛ばさない
  • 適切なマークアップ(リスト、引用など)を使用
  • リンクや画像には説明的なテキストを提供

よくある間違い

1. リスト書式の間違い

間違い:
-項目一(スペースなし)
- 項目二

正しい:
- 項目一
- 項目二

2. リンク書式の間違い

間違い:
(リンクテキスト)[URL]

正しい:
[リンクテキスト](URL)

3. コードブロックのインデント

错误:
```
代码
```

正确:
```
代码
```

ツールのコツ

MD-PDF-WORDの使用

MD-PDF-WORDはこれらすべてのMarkdown構文を完璧にサポートし、PDFやWord形式に正確に変換できます:

  • すべての書式を保持
  • 表を正しくレンダリング
  • コードハイライトに対応
  • 日本語レイアウトを処理

ショートカットキー(一般的なエディター)

機能 Windows/Linux Mac
太字 Ctrl + B Cmd + B
斜体 Ctrl + I Cmd + I
リンク Ctrl + K Cmd + K
コード Ctrl + ` Cmd + `

学習リソース

まとめ

Markdown構文を習得することで、書式設定された文書をより効率的に作成できます。基本的なテキスト書式から高度な表やコードブロックまで、Markdownは豊富でシンプルな構文を提供します。MD-PDF-WORDなどのツールと組み合わせることで、Markdown文書を簡単にプロフェッショナルなPDFやWord形式に変換し、さまざまな文書ニーズに対応できます。

Markdownの核心理念は、書式ではなくコンテンツに集中できることです。必要な構文を選んでシンプルに保ち、美しく保守しやすい文書を作成しましょう。

今すぐMarkdownを実践

MD-PDF-WORDオンラインエディターでこれらの構文を練習しましょう

エディターを開く 拡張機能をインストール