Markdown 内部链接在 BitBucket README.md 中不起作用

Question

我在 BitBucket 项目中有一个 README.md 文件，内容类似于

## Table of Contents

* [Document Organization](#document-organization)

...

## Document Organization

当我使用 Sublime Text 在浏览器中打开 Markdown 预览时，目录中的链接会跳转到相应的部分，但是当我将文件上传到 BitBucket 时，URL 看起来是正确的，但它不会跳转到该部分。

我该如何解决这个问题？

Answer 1

我会检查锚标记上生成的 html，根据我对 bitbuckets auto-ids 的记忆，我怀疑您的链接需要看起来更像

* [Document Organization](#markdown-header-document-organization)

Answer 2

这是一个为 Bitbucket 自述文件（或其他 Markdown 文件）生成目录的片段。

cat readme.md  |\
grep "^#" |\
sed 's|^[ ]*||g' |\
awk  -F, '\
BEGIN {
}{
  basic_name=$1;
  anchor=basic_name
  basic_name_no_hash=basic_name
  gsub(/^[#]* /,"",basic_name_no_hash)
  gsub(/[ ]*$/,"",basic_name_no_hash)
  subs_string=basic_name
  subs = gsub(/#/,"",subs_string);
  gsub(/^[#]+ /,"",anchor);
  gsub(/ /,"-",anchor);
  anchor = tolower(anchor);
  {for (i=0;i<subs-1;i++) printf "    " }
  print "* [" basic_name_no_hash "](#markdown-header-" anchor ")";
}
END {
}'

Answer 3

它对我有用（Atlassian Bitbucket v6.10.0）：

## Table of Contents

* [Document Organization](#document-organization)

...

## Document Organization <a name="document-organization"></a>

只需将锚链接

<a name="document-organization"></a>

添加到标题行即可。

Answer 4

这也可以。

根据此：https://confluence.atlassian.com/bitbucket/mark-up-comments-305037452.html，bitbucket支持目录扩展，可以根据文档自动生成链接和锚点标题。

TOC 扩展记录在此处：https://python-markdown.github.io/extensions/toc/

将文本“[TOC]”添加到要生成的文档的开头。

Answer 5

这是一个与 BitBucket 和其他 md 文件编辑器一起使用的解决方案。

1. [Header one](#custom-id-1)
2. [Header two](#other-id)
    1. [Subheader](#id)
    2. [Subsubheader](#isidtoo)

# Header one <a name="custom-id-1" id="custom-id-1"></a>
# Header two <a name="other-id" id="other-id"></a>
## Subheader <a name="id" id="id"></a>
### Subsubheader  <a name="isidtoo" id="isidtoo"></a>