はじめに
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 "オプションタイトル"
引用
> これは引用です
> 複数行にできます
> 
> > ネストした引用も可能です
コード
インラインコード
`バッククォート`で囲んでインラインコードを表現
コードブロック
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公式ドキュメント
 - GitHubガイド:GitHub Markdownガイド
 - インタラクティブチュートリアル:Markdown Tutorial
 - オンラインプレビュー:MD-PDF-WORDのリアルタイムプレビュー機能を使用
 
まとめ
Markdown構文を習得することで、書式設定された文書をより効率的に作成できます。基本的なテキスト書式から高度な表やコードブロックまで、Markdownは豊富でシンプルな構文を提供します。MD-PDF-WORDなどのツールと組み合わせることで、Markdown文書を簡単にプロフェッショナルなPDFやWord形式に変換し、さまざまな文書ニーズに対応できます。
Markdownの核心理念は、書式ではなくコンテンツに集中できることです。必要な構文を選んでシンプルに保ち、美しく保守しやすい文書を作成しましょう。