如何链接到我的 Bitbucket README 的 Markdown 部分？答案

【问题标题】：How can I link to a Markdown section of my Bitbucket README?如何链接到我的 Bitbucket README 的 Markdown 部分？
【发布时间】：2023-04-02 19:56:01
【问题描述】：

我正在尝试创建指向我的 Bitbucket 存储库的 README 文件部分的链接。以下在 GitHub 上按预期工作，但在 Bitbucket 上没有。我做错了什么？

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

... 

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

【问题讨论】：

我投票决定将此问题作为题外话结束，因为它要求用户对特定站点的支持；见meta.stackoverflow.com/questions/255745/…。
结束这个问题似乎不公平。这个one about GitHub wikis 保持打开状态。

标签： git github markdown bitbucket

【解决方案1】：

Bitbucket 的 Markdown“风味”的一个特点是它命名标题标识符的方式。如果您检查 Bitbucket README 页面的 HTML 源代码（默认情况下可在 https://bitbucket.org/<username>/<reponame> 访问），您会看到 Markdown 部分

## 1. Git To Work - Wording with git

转换为以下 HTML 标题元素：

<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 代码中创建指向相应部分的链接，使用

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

【讨论】：

我的 Bitbucket 不会为标头生成“id”属性。它只是简单的“
YAML 配置
”。我怎样才能链接到它？ (Atlassian Bitbucket v5.8.0)
我们内部的 BitBucket 也不会在 h2 上自动生成 ID。
刚刚使用这个答案来获得可能更新的解决方案 - 对我来说，我使用了 [Link to Git](#markdown-header-git-to-work-working-with-git) - 前缀为 markdown-header （而不是 markdown-header-1 或任何数字）。谢谢！
在 Bitbucket Server 上，标头标签上没有生成名称或 id，它会去除 id 属性，因此您不得不使用 name 并链接到指定的名称。
这很公平。我只是在添加细微差别，因为我很确定 Bitbucket Cloud 可以按照您的回答提供。

【解决方案2】：

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

[link](#section) 

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

【讨论】：

为我工作（BB 7.6.0），而接受的答案没有。这也是 Atlassian 支持网站上公认的解决方案：community.atlassian.com/t5/Bitbucket-questions/…
谢谢，<a name> 标签适用于 Bitbucket 服务器。但是，当将其放在标题标题后面时，单击链接将滚动到标题下方的行（例如标题标题在页面上不可见）。要解决此问题，请将锚点移动到标题前面，即 ## <a name="section"></a>Code and Syntax highlighting
更新：虽然这在 2021 年 5 月有效，但现在不再有效。我们需要根据批准的答案切换到使用前缀#markdown-header-。

YAML 配置