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

【问题标题】：Markdown internal links not working in BitBucket README.mdMarkdown 内部链接在 BitBucket README.md 中不起作用
【发布时间】：2013-10-14 20:27:51
【问题描述】：

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

## Table of Contents

* [Document Organization](#document-organization)

...

## Document Organization

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

我该如何解决这个问题？

【问题讨论】：

标签： markdown bitbucket

【解决方案1】：

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

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

【讨论】：

枚举多个同名标题，例如#markdown-header-document-organization_1、_2等
请注意，您必须在答案中包含前缀 markdown-header 后跟部分名称。然后它作为一个 bitbucket README.md 工作。工作示例：bitbucket.org/tutorials/markdowndemo/overview
是的，效果很好。从浏览器查看 HTML 源代码帮助我理解了一切。基本上 [Abc Def Xyz] 会自动转换为 (#markdown-header-abc-def-xyz)。因此，只需用 hiphen 字符替换空格并注意所有字符都转换为小写。因此，例如：[SDK API] 变为 (#markdown-header-sdk-api)

【解决方案2】：

这是一个用于为 Bitbucket 自述文件（或其他降价文件）生成目录的 sn-p。

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 {
}'

【讨论】：

我还没试过。但是，如果它有效的话，代码很好。谢谢。

【解决方案3】：

这也可以。

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

TOC 扩展在此处记录：https://pythonhosted.org/Markdown/extensions/toc.html

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

【讨论】：

【解决方案4】：

它适用于我（Atlassian Bitbucket v6.10.0）：

## Table of Contents

* [Document Organization](#document-organization)

...

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

只需在标题行添加一个锚链接<a name="document-organization"></a>。

【讨论】：