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