github - 在 GitHub 上将 Markdown 中的引用链接作为项目符号列表包含在内

Question

目前，我在 GitHub 上一个项目的 README.md 文件中使用此 Markdown 文本:

See the docs of [testthat][3] on how to write unit tests.

Links
-----

- http://www.rstudio.com/products/rpackages/devtools/
- https://github.com/hadley/testthat
- http://r-pkgs.had.co.nz/tests.html

---

[1]: http://www.rstudio.com/products/rpackages/devtools/
[2]: https://github.com/hadley/testthat
[3]: http://r-pkgs.had.co.nz/tests.html

我不喜欢这种重复，但我看不出我有什么选择。如果我删除了明确的项目符号列表，那么 GitHub 将不会显示引用链接。如果我删除引用链接，则 GitHub 会显示项目符号列表(当然)，但上面的“testthat”等嵌入式链接不起作用。

有没有比复制更好的方法？我错过了什么？

Answer 1

灵感来自 @mb21 ，我想这将是正确的方法:

See the docs of [testthat][2] on how to write unit tests.

Links
-----

- [RStudio Devtools][1]
- [testthat][2]
- [More unit test examples][3]

[1]: https://stackoverflow.com/users/214446/mb21
[2]: https://github.com/hadley/testthat
[3]: http://r-pkgs.had.co.nz/tests.html

也就是说，逐字包含链接并且没有有意义的标题并不是一个好习惯。我应该只在底部的引用链接部分保留链接 URL，并在项目符号列表中使用有意义的标题。

当您在 GitHub 上查看此内容时，URL 应该无关紧要，如果您真的想知道，可以将鼠标移到上面。当您以纯文本形式查看此内容时，现在链接具有有意义的标题，这是有关 URL 的有用附加信息。