Qiitaで記事書いてる人たち、ページ内リンクで困ったことないですか?
僕はこんな寄り道みたいなところでとても困りました。
書き方にいくつかルールがあるみたいなんですけど、あんまり情報が見つからなかったのでまとめておきます。
公式のマニュアルとかあったらごめんなさい……
他にも見つけ次第追記していこうと思います。
-
スラッシュ類の/と\は省略を追記しました。半角記号はアンダーバー_とハイフン-以外省略にまとめられました - 半角と全角に分け、大幅に加筆、修正しました
- 半角記号の省略をまとめました
- 全角記号の省略をまとめました
ページ内リンクの書き方
知っているとは思いますけど一応。
# hoge
## fuga
[hoge](#hoge)
[fuga](#fuga)
見出しの深さに関係なく#
は必ず1つです。
これも躓いた……
半角
英字の大文字ABCは小文字abcで
## 英字の大文字ABCは小文字abcで
[英字の大文字ABCは小文字abcで](#英字の大文字abcは小文字abcで)
空白 はハイフン-で
## 空白 はハイフン-で
[空白 はハイフン-で](#空白-はハイフン-で)
半角記号はアンダーバー_とハイフン-以外省略
半角記号!@#$%^&*()+|~=`[]{};':",./<>?は省略
半角記号!@#$%^&*()+|~=`[]{};':",./<>?は省略
### 半角記号!@#$%^&*()+|~=\`[]{};':",./<>?は省略
[半角記号!@#$%^&*()+|~=\`[]{};':",./<>?は省略](#半角記号は省略)
全角
英字の大文字ABCは小文字abcで
## 英字の大文字ABCは小文字abcで
[英字の大文字ABCは小文字abcで](#英字の大文字abcは小文字abcで)
空白 は省略
## 空白 は省略
[空白 は省略](#空白は省略)
半角とはルールが異なるので注意です。
全角記号はアンダーバーとハイフン以外省略
正確にはキーボードにあるものだけです。
全角記号!@#$%^&*()+|〜=¥`「」{};’:”、。・<>?は省略
全角記号!@#$%^&*()+|〜=¥`「」{};’:”、。・<>?は省略
### 全角記号!@#$%^&*()+|〜=¥`「」{};’:”、。・<>?は省略
[全角記号!@#$%^&*()+|〜=¥`「」{};’:”、。・<>?は省略](#全角記号は省略)
全角括弧類の【】と『』と《》と〔〕と[]と‹›と«»と〘〙と〚〛は省略
全角括弧類の【】と『』と《》と〔〕と[]と‹›と«»と〘〙と〚〛は省略
## 全角括弧類の【】と『』と《》と〔〕と[]と‹›と«»と〘〙と〚〛は省略
[全角括弧類の【】と『』と《》と〔〕と[]と‹›と«»と〘〙と〚〛は省略](#全角括弧類のととととととととは省略)
一応キーボードにない記号も一部試してみました。
さすがにすべての記号は試せませんけど、アンダーバーとハイフン以外は使えそうにない雰囲気です。
全角記号はとりあえず省略してみれば大丈夫そうですね。
注意
上記の省略によってページ内リンクが被ることがあります。
## /と\は省略
[/と\は省略](#とは省略)
## !と?は省略
[!と?は省略](#とは省略)
滅多なことでは起こらないと思いますけどね。
一応心の片隅にでも留めておくといいかもしれません。
コメントで教えていただいたので、下の同じヘッダーにまとめました。
同じヘッダー
コメントでご指摘いただいたように、ヘッダーのハッシュが重複した場合、2つ目以降は末尾に-n
と1からの連番が付くようです。
-0
は存在しないようです。
## 同じヘッダー
[同じヘッダー-0](#同じヘッダー-0)
[同じヘッダー](#同じヘッダー)
[同じヘッダー-1](#同じヘッダー-1)
[同じヘッダー-2](#同じヘッダー-2)
同じヘッダー
## 同じヘッダー
[同じヘッダー-1](#同じヘッダー-1)
同じヘッダー
## 同じヘッダー
[同じヘッダー-2](#同じヘッダー-2)