In Markdown, there are different way to use links. So the goal is to output:
You can find our website at histographistes.com
Links can be inline, but we can't specify a text:
You can find our website at <https://histographistes.com>.Links can be inline with a special text:
You can find our website at [histographistes.com](https://histographistes.com).Or they can be placed at the bottom of the text as references:
You can find our website at [histographistes.com][id].
[id]: https://histographistes.comOr they can be placed without id:
You can find our website at [histographistes.com].
[histographistes.com]: https://histographistes.comTo sumarize my thinking with a table:
<a> |
[a](b) |
[a][b] |
[a] |
|
|---|---|---|---|---|
| conciseness | ✔️ | ❌ | ❌ | ✔️ |
| lisibility | ❌ | ❌ | ❌ | ✔️ |
| title | ❌ | ✔️ | ✔️ | ✔️ |
So my clear favorite is to go with [a].
Example from FOSS Acronyms:
Keep in mind that the [readme.md] is generated. It is useless to edit it directly.
If you want to add or update an acronym, edit the correct file in the [data] folder (e.g. [acronyms.json]).Source: