【问题标题】: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?

【问题讨论】:

标签: git github markdown bitbucket


【解决方案1】:

Bitbucket 的 Markdown“风味”的一个特点是它命名标题标识符的方式。如果您检查 Bitbucket README 页面的 HTML 源代码(默认情况下可在 https://bitbucket.org/&lt;username&gt;/&lt;reponame&gt; 访问),您会看到 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/…
  • 谢谢,&lt;a name&gt; 标签适用于 Bitbucket 服务器。但是,当将其放在标题标题后面时,单击链接将滚动到标题下方的行(例如标题标题在页面上不可见)。要解决此问题,请将锚点移动到标题前面,即 ## &lt;a name="section"&gt;&lt;/a&gt;Code and Syntax highlighting
  • 更新:虽然这在 2021 年 5 月有效,但现在不再有效。我们需要根据批准的答案切换到使用前缀#markdown-header-
猜你喜欢
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 2013-11-26
  • 1970-01-01
  • 1970-01-01
  • 2011-06-05
  • 2015-07-05
相关资源
最近更新 更多