コンテンツ最適化 - 検索エンジンに評価される記事の書き方¶

メインキーワード: "MkDocs GitHub Pages"
関連キーワード: 
- "MkDocs デプロイ"
- "GitHub Pages 設定"
- "静的サイト 作成"

# [メインキーワードを含むタイトル]

## 導入・概要
- 問題提起
- この記事で得られること

## 基本的な手順・方法
- ステップバイステップの説明
- 具体的なコード例

## 応用・カスタマイズ
- より詳細な設定
- トラブルシューティング

## まとめ・次のステップ
- 重要ポイントの再確認
- 関連記事への案内

# MkDocsでGitHub Pagesサイトを構築する完全ガイド

## MkDocsとGitHub Pagesの組み合わせとは
## 必要な前提知識と準備
## ステップ1: MkDocsプロジェクトの作成
## ステップ2: GitHub Actionsによる自動デプロイ設定
## ステップ3: カスタムドメインの設定（オプション）
## よくあるエラーと解決方法

# 方法  # 曖昧すぎる
## 設定  # 何の設定か不明
## その他  # 内容が不明確

## ステップ1: MkDocsのインストール
```bash
pip install mkdocs mkdocs-material

mkdocs new my-project
cd my-project

site_name: My Docs
theme:
  name: material

### 2. トラブルシューティング情報の充実

```markdown
## よくあるエラーと対処法

### エラー: "Config file 'mkdocs.yml' not found"
**原因**: プロジェクトのルートディレクトリにいない
**解決策**: `cd my-project` でプロジェクトディレクトリに移動

### エラー: "ModuleNotFoundError: No module named 'material'"  
**原因**: mkdocs-materialがインストールされていない
**解決策**: `pip install mkdocs-material` を実行

## 実際の設定例

このサイトで使用している実際のmkdocs.yml設定：

```yaml
site_name: note
theme:
  name: 'material'
  language: 'ja'
  palette:
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: teal
      accent: deep orange
plugins:
  - search:
      lang: ja

## SEOを意識した記事作成のポイント

### 1. タイトルの最適化

**良いタイトルの特徴**:
- メインキーワードを含む（できれば前半に）
- 記事の内容を正確に表現
- 32文字以内（検索結果で全て表示される）
- 魅力的で클릭したくなる表現

**例**:
✅ `MkDocsでGitHub Pages構築 - 初心者向け完全ガイド`
❌ `サイトの作り方について`

### 2. メタ説明（description）の作成

MkDocsでは記事の先頭でメタ情報を設定：

```markdown
---
description: "MkDocsとGitHub Pagesを使って技術ドキュメントサイトを構築する方法を、初心者向けに詳しく解説。環境構築からデプロイ、カスタマイズまで完全網羅。"
---

## 実際にこの方法を使って感じたメリット

1. **デプロイ時間の短縮**: 従来の手動デプロイと比べて70%時間短縮
2. **エラー率の低下**: 自動化により設定ミスがなくなった
3. **保守性の向上**: GitHub Actionsのログでトラブルシューティングが容易

## パフォーマンス改善結果

Material for MkDocsテーマ導入前後の比較：
- **ページ読み込み速度**: 3.2秒 → 1.8秒（44%改善）
- **モバイルスコア（PageSpeed Insights）**: 72 → 89（23%向上）
- **検索機能の精度**: 日本語対応により検索ヒット率が約3倍向上

## 環境別の設定手順

### Windowsの方
```cmd
# Windows PowerShell
pip install mkdocs mkdocs-material

# Terminal
pip3 install mkdocs mkdocs-material

## コンテンツの効果測定

### 1. Googleアナリティクス

**確認すべき指標**:
- **滞在時間**: コンテンツの質の指標
- **直帰率**: ユーザーの満足度
- **ページビュー**: 人気記事の特定
- **コンバージョン**: 記事の最終的な成果

### 2. Google Search Console

**重要な指標**:
- **平均掲載順位**: 記事のSEOパフォーマス
- **クリック率（CTR）**: タイトルの魅力度  
- **表示回数**: 検索でのvisibility
- **検索クエリ**: ユーザーが実際に使用しているキーワード

### 3. ユーザーフィードバック

Material for MkDocsのフィードバック機能を活用：

```yaml
extra:
  analytics:
    feedback:
      title: この記事は役に立ちましたか？
      ratings:
        - icon: material/emoticon-happy-outline
          name: 役に立った
          data: 1
        - icon: material/emoticon-sad-outline  
          name: 改善が必要
          data: 0

# mkdocs.yml
markdown_extensions:
  - meta
  - attr_list

---
schema_type: "HowTo"
estimated_time: "PT15M"
skill_level: "Beginner"
---

![MkDocs設定画面](images/mkdocs-config.png "MkDocsの設定画面")
*図1: MkDocsプロジェクトの基本的な設定画面*

plugins:
  - i18n:
      default_language: ja
      languages:
        ja: Japanese
        en: English