Bitbucket Wikiでのアンカーの付け方


はじめに

  • Bitbucket Wikiでドキュメントをまとめようとしていたところ,Markdownアンカーリンクがうまく設定できなかった
  • 解決できたので,その方法

問題の事象

下記のようなマークダウンを書いた場合,どちらもアンカーリンクが動作しない

(はじめに)[#はじめに]
(usage)[#usage]

# はじめに
...

# usage
...

調査

ヘッダー部分のHTMLを確認してみると以下のようになっていた

<h1 id="markdown-header-_1">はじめに</h1>
<h1 id="markdown-header-usage">usage</h1>

解決方法

  • リンクを指定する際に#markdown-header-をプレフィックスとして追加する
  • 日本語の場合は通し番号が付与されるので,それを指定する
(はじめに)[#markdown-header-_1]
(usage)[#markdown-header-usage]

# はじめに
...

# usage
...