【ページ内リンク】markdownとQiitaの書き方の違い (アンカーリンク設定時の注意)

　【ページ内リンク】markdownとQiitaの書き方の違い

ページ内リンクを設置するときに、ｍarkdown（.mdファイル）とQiitaで一部ルールに違いがある。
気になって検証した結果のメモ

共通の型

[アンカーテキスト](#リンク先の見出し)
　　└大枠の型は外部へのテキストリンクの設置と同じ
　　└（ ）の中が「#」＋「見出しテキスト」になる（*外部リンクはURL）

⇛ リンク型はQiitaもmarkdownファイルもどちらも同じ

Qiitaの書き方要点まとめ

• 「#」の数　⇒　１個
• 記号　⇒　削除
  • ハイフン　⇒　そのまま
  • アンダーバー　⇒　そのまま
• 半角スペース　⇒　「-」ハイフンに変換
• 全角スペース　⇒　削除
• 数字　⇒　そのまま
• 大文字アルファベット　⇒　小文字に変換
• 小文字アルファベット　⇒　そのまま

全角・半角文字別の詳細

- 半角記号　⇒　削除　（※「-」「_」は例外）
- 半角アンダーバー　⇒　そのまま
- 半角ハイフン　⇒　そのまま
- 全角記号　⇒　削除（※「ー」「＿」は例外）
- 全角アンダーバー　⇒　そのまま
- 全角ハイフン　⇒　そのまま
- 半角スペース　⇒　「-」に変換
- 全角スペース　⇒　削除
- 全角数字　⇒　そのまま
- 半角数字　⇒　そのまま
- 全角大文字アルファベット　⇒　小文字に変換
- 半角大文字アルファベット　⇒　小文字に変換
- 全角小文字アルファベット　⇒　そのまま
- 半角小文字アルファベット　⇒　そのまま

詳細はこちらにまとめてあります。

Markdownファイルの書き方要点（Qiitaとの違い）

• 記号はあってもなくてもいい（Qiitaは基本省略）
• 全角スペースはそのまま（Qittaは省略）
• アルファベットの大文字も使える（Qiitaはすべて小文字になおす）
  • ※ただし、小文字と大文字の区別はされない
• 「<>」も使える（Qiitaでは使えない）
  • ※ないものとして扱われる
  • ※記号のみは使えない（Qiitaも同じ）
• 全角記号は文字列として使える（Qiitaは省略）
  • 「＜＞」などが使える

markdownファイルの注意点

同じリンク先を参照するパターンが発生する

大文字と小文字の区別がない

例えば、「###AAA」という見出しに対して①～④がすべて同じリンク先になる

①AAA
②aaa
③AAA@
④aaa@!+-#$%&<>

※マークダウンファイルの話なので、ここでは飛ばない

[AAA](#AAA)
[aaa](#aaa)
[AAA@](#AAA@)
[aaa@!+-#$%&<>](#aaa@!+-#$%&<>)

• 大文字と小文字の区別がない（A=a)
• 記号は省略される
• リンク先の見出しは上にあるものが優先される

「###AAA」、「###aaa」、「###AAA@」が順に設置してある場合に、すべて「###AAA」に飛ぶ

補足(その他のmarkdownファイル(以下md)とQiitaの書き方違い)

• 見出しの「#」のあとに半角スペースが必要（QiitaはなくてもOK）
  • 「#AAA」→　md：NG、Qiita：OK
  • 「# AAA」→　md：OK、Qiita：OK
• 引用の「>」は各行に必要（Qiitaは空白行がなければ一塊として認識）

まとめ

Qiitaはミスが発生しにくい＋使いやすいようにカスタマイズされている。
markdown形式で他のツールやファイルに記述するときは注意が必要かも。