Question

我在BitBucket项目中有一个类似

的README.md文件

## Table of Contents

* [Document Organization](#document-organization)

...

## Document Organization

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

BitBucket存储库是私有的，因此我无法共享它。

我该如何解决这个问题？

Answer 1

我会检查锚标签上生成的html，从我能记得的bitbuckets auto-id中我怀疑你的链接需要看起来更像

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

Answer 2

这是一个为Bitbucket自述文件（或其他降价文件）生成目录的代码段。

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

这也可以。

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

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

添加文字＆＃34; [TOC]＆＃34;到文档的开头，以便生成它。

Answer 4

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

## Table of Contents

* [Document Organization](#document-organization)

...

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

只需将 ancor 链接 <a name="document-organization"></a> 添加到标题行即可。

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

4 个答案: