如何在我的Bitbucket README中链接到一个Markdown部分？

Question

我试图创建一个链接到我的Bitbucket仓库的README文件的某个部分。以下代码在GitHub上可以正常工作，但是在Bitbucket上不起作用。我做错了什么？

## Navigation
[1. GIT To Work](#git)

... 

## 1. Git To Work - Working with git<a name="git"></a>
### What is git?

- Cruzito

---

我投票关闭此问题，因为它要求针对特定网站的用户支持；请参阅http://meta.stackoverflow.com/questions/255745/why-were-not-customer-support-for-your-favorite-company。 - Marcus Müller

关闭这个问题似乎不太公平。这个关于GitHub维基的问题仍然是开放的。 - jub0bs

Answer 1

Bitbucket的Markdown“口味”之一是它命名标题标识符的方式。如果您检查Bitbucket README页面的HTML源代码（默认情况下可以访问https://bitbucket.org/<username>/<reponame>），您会发现Markdown部分的标题标识符与其他标准不同。

## 1. Git To Work - Wording with git

翻译成以下HTML标题元素：

translates to the following HTML heading element:

<h2 id="markdown-header-1-git-to-work-working-with-git">1. Git To Work - Working with git</h2>

注意，Bitbucket使用你标题的URL友好版本作为id属性的值，并在前面加上markdown-header-。因此，你可以在你的Markdown代码中创建一个链接到相应部分的链接。

请注意，Bitbucket使用标题的URL友好版本作为id属性的值，该值的前缀为markdown-header-。因此，在您的Markdown代码中，您可以创建一个链接到相应部分的链接。

[Link to Git](#markdown-header-1-git-to-work-working-with-git)

- jub0bs

---

我的Bitbucket不会为标题生成"id"属性，只是简单地显示"<h2>YAML配置</h2>"。我该如何链接到它？（Atlassian Bitbucket v5.8.0） - emeraldhieu

我们内部的 BitBucket 也不会自动生成 h2 元素的 ID。 - Frank Stallone III

刚刚使用了这个答案，找到了可能更为更新的解决方案 - 对我来说，我使用了[Git链接](#markdown-header-git-to-work-working-with-git) - 在前面加上markdown-header（而不是markdown-header-1或任何数字）。谢谢！ - yair

在Bitbucket Server上，标题标签上既没有名称也没有ID生成，并且它会剥离ID属性，因此您必须使用“name”并链接到指定的名称。 - Maximilian Burszley

那很公平。我只是在添加细节，因为我非常确定Bitbucket Cloud可以像你的答案所提供的那样工作。 - Maximilian Burszley

Answer 2

锚链接在我的Bitbucket服务器上可以工作，但不幸的是在VS Code中不能工作。

[link](#section) 

## Code and Syntax highlighting  <a name="section"></a>

- perry_the_python

---

对我很有用（BB 7.6.0），而被接受的答案却没有。这也是Atlassian支持网站上被接受的解决方案：https://community.atlassian.com/t5/Bitbucket-questions/Markdown-internal-links-support-in-Bitbucket-Server/qaq-p/595033 - sherb

谢谢，<a name>标签在Bitbucket服务器上可以使用。 然而，当将其放置在标题后面时，单击链接会滚动到标题下方的行（例如，页面上看不到标题）。为了解决这个问题，请将锚点移到标题前面，即## <a name="section"></a>Code and Syntax highlighting。 - Martijn

更新：虽然在2021年5月这个方法是可行的，但现在已不再适用。我们需要根据批准的答案切换到使用前缀“#markdown-header-”。 - Martijn

这在2022年7月14日对我有效。 - Wilfred Almeida