Markdownチュートリアル

日本語

English
简体中文
繁体中文
한국어
русский
Français
Deutsch
Italiano

日本語

English
简体中文
繁体中文
한국어
русский
Français
Deutsch
Italiano

Appearance

引用構文 ​

引用ブロックは、引用テキストを強調したり、重要な情報を目立たせたりするために使用されます。Markdownでは、> 記号を使用して引用ブロックを作成します。

基本的な引用構文 ​

1行の引用 ​

行の先頭に > 記号を使用して引用を作成します：

markdown
> これは引用です。

レンダリング結果：

これは引用です。

複数行の引用 ​

markdown
> これは引用の最初の行です。
> これは引用の2行目です。
> これは引用の3行目です。

レンダリング結果：

これは引用の最初の行です。 これは引用の2行目です。 これは引用の3行目です。

引用内の段落 ​

引用内に複数の段落を含めることができます：

markdown
> これは引用の最初の段落です。
>
> これは引用の2番目の段落です。

レンダリング結果：

これは引用の最初の段落です。

これは引用の2番目の段落です。

ネストされた引用 ​

基本的なネスト ​

>> を使用して、ネストされた引用を作成します：

markdown
> これは1レベルの引用です。
>
> > これは2レベルの引用です。
>
> 再び1レベルの引用に戻ります。

レンダリング結果：

これは1レベルの引用です。

これは2レベルの引用です。

再び1レベルの引用に戻ります。

多重ネスト ​

markdown
> レベル1の引用
> > レベル2の引用
> > > レベル3の引用
> > > > レベル4の引用
> >
> > レベル2に戻る
>
> レベル1に戻る

レンダリング結果：

レベル1の引用

レベル2の引用

レベル3の引用

レベル4の引用

レベル2に戻る

レベル1に戻る

引用内のその他の要素 ​

引用内のフォーマット ​

markdown
> **太字テキスト** と *斜体テキスト* は通常の引用内で機能します。
> 
> インラインコードやその他のフォーマットを使用できます。

レンダリング結果：

太字テキスト と 斜体テキスト は通常の引用内で機能します。

インラインコードやその他のフォーマットを使用できます。

引用内の見出し ​

markdown
> ## 引用内の見出し
> 
> これは引用内のメインコンテンツです。
> 
> ### サブ見出し
> 
> より引用されたコンテンツ。

レンダリング結果：

引用内の見出し ​

これは引用内のメインコンテンツです。

サブ見出し ​

より引用されたコンテンツ。

引用内のリスト ​

markdown
> 引用内のリスト：
> 
> 1. 最初の項目
> 2. 2番目の項目
> 3. 3番目の項目
> 
> または順序なしリスト：
> 
> - 項目A
> - 項目B
> - 項目C

レンダリング結果：

引用内のリスト：

  1. 最初の項目
  2. 2番目の項目
  3. 3番目の項目

または順序なしリスト：

  • 項目A
  • 項目B
  • 項目C

引用内のコードブロック ​

markdown
> ここにコード例を示します：
> 
> ```javascript
> function hello() {
>   console.log("Hello, World!");
> }
> ```
> 
> コードブロックも引用内で正しく表示されます。

レンダリング結果：

ここにコード例を示します：

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

コードブロックも引用内で正しく表示されます。

引用内のリンク ​

markdown
> 公式ドキュメント [https://www.markdownlang.com](https://www.markdownlang.com) についてより詳細な情報をご覧ください。
> 
> 直接リンクを訪問することもできます <https://www.markdownlang.com>。

レンダリング結果：

公式ドキュメント https://www.markdownlang.com についてより詳細な情報をご覧ください。

直接リンクを訪問することもできます https://www.markdownlang.com。

一般的な使用シナリオ ​

1. 文学的引用 ​

markdown
> 「Markdownは、人々が読みやすく書きやすいプレーンテキスト形式でドキュメントを作成できる軽量マークアップ言語です。」
> 
> —— John Gruber、Markdownの作成者

レンダリング結果：

「Markdownは、人々が読みやすく書きやすいプレーンテキスト形式でドキュメントを作成できる軽量マークアップ言語です。」

—— John Gruber、Markdownの作成者

2. 警告メッセージ ​

markdown
> ⚠️ **警告**
> 
> この操作を実行すると、すべてのデータが削除されます。重要なファイルを必ずバックアップしてください。

レンダリング結果：

⚠️ 警告

この操作を実行すると、すべてのデータが削除されます。重要なファイルを必ずバックアップしてください。

3. ヒントメッセージ ​

markdown
> 💡 **ヒント**
> 
> ショートカット `Ctrl+S` を使用して、ドキュメントをすばやく保存します。

レンダリング結果：

💡 ヒント

ショートカット Ctrl+S を使用して、ドキュメントをすばやく保存します。

4. 重要な注意 ​

markdown
> 📌 **重要な注意**
> 
> 開始する前に、以下の依存関係がインストールされていることを確認してください：
> 
> - Node.js (>= 14.0)
> - npm (>= 6.0)
> - Git

レンダリング結果：

📌 重要な注意

開始する前に、以下の依存関係がインストールされていることを確認してください：

  • Node.js (>= 14.0)
  • npm (>= 6.0)
  • Git

一般的なエラーと解決策 ​

1. > 記号が不足 ​

markdown
❌ 誤っています：
> 引用の最初の行
> 二行目に > 記号がありません ← この行は引用に含まれません

✅ 正しい：
> 引用の最初の行
> > 二行目が正しく引用されています

2. ネストレベルエラー ​

markdown
❌ 誤っています：
> レベル1
> > > レベル3に直接ジャンプ ← レベル2をスキップ

✅ 正しい：
> レベル1
> > レベル2
> > > レベル3

3. 空白行の処理 ​

markdown
❌ 潜在的な問題：
> 最初の段落

> 二番目の段落  ← これにより、2つの別々の引用が作成されます

✅ 複数段落引用の正しい処理：
> 最初の段落
>
> 二番目の段落

ベストプラクティス ​

1. スタイルを統一する ​

markdown
✅ 推奨：統一された引用スタイル
> すべての重要な情報は引用を使用します
> フォーマットを一貫させます

❌ 推奨されません：混合使用
> 時々引用を使用
**時々太字を使用**

2. ネストを適切に使用する ​

markdown
✅ 推奨：シンプルで明確なネスト
> メインポイント
> > 支持論拠
> 
> メインポイントを続ける

❌ 推奨されません：深すぎるネスト
> > > > > 深すぎる、読みにくい

3. 意味を持たせる ​

markdown
✅ 推奨：意味のある引用
> これは権威ある文書からの重要な情報です

❌ 推奨されません：装飾的な引用
> これは通常のテキストであり、引用フォーマットは不要です

HTML出力 ​

Markdownの引用はHTMLに変換されます：

markdown
> これは引用されたテキストです

なる：

html
<blockquote>
  <p>これは引用されたテキストです</p>
</blockquote>

ネストされた引用：

markdown
> レベル1
> > レベル2

なる：

html
<blockquote>
  <p>レベル1</p>
  <blockquote>
    <p>レベル2</p>
  </blockquote>
</blockquote>

カスタムスタイル ​

いくつかのMarkdownプロセッサはカスタム引用スタイルをサポートします：

GitHub-style Admonitions ​

markdown
> [!NOTE]
> これは情報ノートです

> [!WARNING]
> これは警告ノートです

> [!IMPORTANT]
> これは重要なノートです

HTMLとCSSを使用する ​

markdown
<blockquote style="border-left: 4px solid #3498db; padding-left: 1em; color: #7f8c8d;">
これはカスタムスタイルの引用です
</blockquote>

実践的な例 ​

APIドキュメントでの例 ​

markdown
## ユーザー認証

ユーザー認証はAPIにアクセスするために必要なステップです。

> **認証方法**
> 
> 私たちのAPIはBearer Token認証を使用します：
> 
> ```bash
> curl -H "Authorization: Bearer YOUR_TOKEN" \
>      https://api.example.com/users
> ```

### リクエスト例

POSTリクエストを送信してユーザーを作成します：

> ```json
> {
>   "name": "John Doe",
>   "email": "john@example.com",
>   "role": "user"
> }
> ```

チュートリアルのノート ​

markdown
## インストール手順

1. インストーラーをダウンロード
2. インストーラーを実行

> ⚠️ **注意**
> 
> インストール前に：
> - ウイルス対策がオフになっている
> - 管理者として実行
> - システムディスクに少なくとも2GBの空き容量がある

3. インストールウィザードを完了

関連構文 ​

練習 ​

以下を試してください：

  1. 複数段落を含む引用を作成
  2. 3レベルのネストされた引用構造を作成
  3. 技術的な引用を含む引用を作成
  4. 会話を模倣するネストされた引用を作成

Build by www.markdownlang.com

MITライセンス | Copyright © 2023-現在