Markdownチュートリアル

日本語

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

日本語

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

Appearance

リスト構文 ​

リストは情報を整理する重要な方法です。Markdownは、順序付きリスト、順序なしリスト、ネストされたリスト、タスクリストをサポートしています。

順序なしリスト ​

基本構文 ​

-、*、または + を使用して順序なしリストを作成します：

markdown
- 項目1
- 項目2
- 項目3

* 項目1
* 項目2
* 項目3

+ 項目1
+ 項目2
+ 項目3

レンダリング結果：

  • 項目1
  • 項目2
  • 項目3

記号選択のアドバイス ​

記号特徴推奨シナリオ
-最も一般的、簡潔一般的に推奨
*強調構文と一貫性があるスタイルの一貫性のため
+ほとんど使用されない特別な区別のため

ヒント： 文書全体で記号の一貫性を保ちます。

順序付きリスト ​

基本構文 ​

数字とピリオドを使用して順序付きリストを作成します：

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

レンダリング結果：

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

番号付け ​

実際の数値は関係ありません。Markdownは自動的に正しい順序を生成します：

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

レンダリング結果：

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

開始番号 ​

開始番号を指定できます：

markdown
3. 3番目の項目
4. 4番目の項目
5. 5番目の項目

レンダリング結果：

  1. 3番目の項目
  2. 4番目の項目
  3. 5番目の項目

ネストされたリスト ​

基本的なネスト ​

インデント（2〜4スペース）を使用してネストされたリストを作成します：

markdown
- レベル1の項目1
  - レベル2の項目1.1
  - レベル2の項目1.2
- レベル1の項目2
  - レベル2の項目2.1
    - レベル3の項目2.1.1
    - レベル3の項目2.1.2
  - レベル2の項目2.2

レンダリング結果：

  • レベル1の項目1
    • レベル2の項目1.1
    • レベル2の項目1.2
  • レベル1の項目2
    • レベル2の項目2.1
      • レベル3の項目2.1.1
      • レベル3の項目2.1.2
    • レベル2の項目2.2

混合ネスト ​

順序付きリストと順序なしリストを相互にネストできます：

markdown
1. 順序付き項目1
   - 順序なしサブ項目1.1
   - 順序なしサブ項目1.2
2. 順序付き項目2
   1. 順序付きサブ項目2.1
   2. 順序付きサブ項目2.2
      - 順序なしサブサブ項目2.2.1
      - 順序なしサブサブ項目2.2.2

レンダリング結果：

  1. 順序付き項目1
    • 順序なしサブ項目1.1
    • 順序なしサブ項目1.2
  2. 順序付き項目2
    1. 順序付きサブ項目2.1
    2. 順序付きサブ項目2.2
      • 順序なしサブサブ項目2.2.1
      • 順序なしサブサブ項目2.2.2

リスト内の複数段落コンテンツ ​

段落の継続 ​

リスト項目内に複数の段落を含めます：

markdown
1. 最初の項目

   これは最初の項目の2番目の段落です。リスト項目内に保持するためにインデントします。

2. 2番目の項目

   これは2番目の項目の2番目の段落です。
   
   これは2番目の項目の3番目の段落です。

3. 3番目の項目

レンダリング結果：

  1. 最初の項目

    これは最初の項目の2番目の段落です。リスト項目内に保持するためにインデントします。

  2. 2番目の項目

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

    これは2番目の項目の3番目の段落です。

  3. 3番目の項目

コードブロック ​

リスト内にコードブロックを含めます：

markdown
1. 依存関係のインストール

   ```bash
   npm install express

  1. サーバーの作成

    javascript
    const express = require('express');
const app = express();

  2. サーバーの起動


### ブロッククォート

リスト内にブロッククォートを含めます：

```markdown
1. 準備

   > 十分なディスク容量があることを確認してください
   > 少なくとも10GBが推奨されます

2. インストールの開始

タスクリスト ​

基本構文 ​

- [ ] を未完了タスク、- [x] を完了タスクに使用します：

markdown
- [x] 完了したタスク
- [ ] 未完了のタスク
- [x] 別の完了したタスク
- [ ] やるべき項目

レンダリング結果：

  • [x] 完了したタスク
  • [ ] 未完了のタスク
  • [x] 別の完了したタスク
  • [ ] やるべき項目

ネストされたタスクリスト ​

markdown
- [x] プロジェクト計画
  - [x] 要件分析
  - [x] 技術調査
  - [ ] プロトタイプ設計
- [ ] 開発フェーズ
  - [ ] フロントエンド開発
    - [x] ページレイアウト
    - [ ] インタラクティブ機能
  - [ ] バックエンド開発
    - [ ] API設計

共通のエラーと解決策 ​

1. 不正なインデント ​

markdown
❌ エラー：不整合なインデント
- 項目1
  - サブ項目1.1
    - サブ項目1.2  ← インデントエラー

✅ 正しい：一貫したインデント
- 項目1
  - サブ項目1.1
  - サブ項目1.2

2. リスト項目間の空白行 ​

markdown
❌ エラー：不要な空白行がリストを中断
- 項目1

- 項目2  ← これにより2つの別々のリストが作成されます

✅ 正しい：連続するリスト項目
- 項目1
- 項目2

3. 番号の後のスペース ​

markdown
❌ エラー：
1.First item  ← スペースが不足
2.Second item

✅ 正しい：
1. First item
2. Second item

特殊なケース ​

リスト記号のエスケープ ​

リスト記号を行の先頭に表示したい場合は、リストを作成しないようにします：

markdown
\- これはリスト項目ではありません
\* これはリスト項目ではありません
\1. これは順序付きリスト項目ではありません

レンダリング結果：

- これはリスト項目ではありません * これはリスト項目ではありません \1. これは順序付きリスト項目ではありません

リスト項目内のコード ​

markdown
- npm install package-name をインストール
- npm start を実行
- ブラウザで http://localhost:3000 を開く

レンダリング結果：

  • npm install package-name をインストール
  • npm start を実行
  • ブラウザで http://localhost:3000 を開く

リスト項目内のリンク ​

markdown
- [GitHub](https://github.com) - コードホスティングプラットフォーム
- [Stack Overflow](https://stackoverflow.com) - Q&Aサイト
- [MDN](https://developer.mozilla.org) - 開発者ドキュメント

レンダリング結果：

  • GitHub - コードホスティングプラットフォーム
  • Stack Overflow - Q&Aサイト
  • MDN - 開発者ドキュメント

ベストプラクティス ​

1. 一貫性を保つ ​

markdown
✅ 推奨：常にダッシュを使用
- 項目A
- 項目B
- 項目C

❌ 推奨されない：記号の混在
- 項目A
* 項目B
+ 項目C

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

markdown
✅ 推奨：適度なネスト
- 主要機能
  - ユーザー管理
  - コンテンツ管理
- 補助機能
  - ログ
  - データバックアップ

❌ 推奨されない：深すぎるネスト
- 機能
  - 主要機能
    - 基本機能
      - 基本機能  ← 深すぎる

3. 意味的に整理する ​

markdown
✅ 推奨：論理的にグループ化
## 開発ツール
- コードエディタ
- バージョン管理
- デバッグツール

## デザインツール
- プロトタイピング
- 画像編集
- UIデザイン

❌ 推奨されない：論理的なグループ化がない
- コードエディタ
- プロトタイピング
- バージョン管理
- 画像編集

HTML出力 ​

MarkdownリストはHTMLに変換されます：

markdown
- 項目1
- 項目2

変換後：

html
<ul>
  <li>項目1</li>
  <li>項目2</li>
</ul>
markdown
1. 項目1
2. 項目2

変換後：

html
<ol>
  <li>項目1</li>
  <li>項目2</li>
</ol>

実践例 ​

買い物リスト ​

markdown
## 今日の買い物リスト

### 日常必需品
- [ ] シャンプー
- [ ] 歯磨き粉
- [x] タオル

### 食品
- [ ] 牛乳
- [ ] パン
- [x] 卵
- [ ] 果物
  - [ ] りんご
  - [x] バナナ
  - [ ] オレンジ

学習計画 ​

markdown
## この月の学習計画

1. **週1**: 基本
   - [x] チュートリアルの第1-3章を読む
   - [x] 演習1-10を完了
   - [ ] 動画レッスン1-5を視聴

2. **週2**: 実践プロジェクト
   - [ ] シンプルなプロジェクトを作成
   - [ ] 基本的な機能を実装
   - [ ] スタイルデザインを追加

3. **週3**: 高度なコンテンツ
   - [ ] 高度な機能を学習
   - [ ] プロジェクトのパフォーマンスを最適化
   - [ ] テストケースを作成

4. **週4**: レビュー
   - [ ] 学習ノートを整理
   - [ ] 最終プロジェクトを準備
   - [ ] 重要なコンテンツを確認

API機能リスト ​

markdown
## APIエンドポイント

### ユーザー管理
1. `GET /api/users` - ユーザーリストを取得
   - ページネーションをサポート
   - 検索フィルタリングをサポート
   
2. `POST /api/users` - 新しいユーザーを作成
   - 管理者権限が必要
   - メールの一意性を検証
   
3. `PUT /api/users/:id` - ユーザー情報を更新
   - ユーザーは自分の情報のみを更新できる
   - 管理者は任意のユーザーを更新できる

### コンテンツ管理
- `GET /api/posts` - 投稿リストを取得
- `POST /api/posts` - 新しい投稿を作成
- `DELETE /api/posts/:id` - 投稿を削除

関連構文 ​

練習 ​

以下の種類のリストを作成します：

  1. 3階層のネストされたプロジェクト構造
  2. コード例を含む技術的な手順リスト
  3. 順序付きリストと順序なしリストを混合した複雑なリスト
  4. タスク状態を含むプロジェクトチェックリスト

Build by www.markdownlang.com

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