Skip to content
Merged
Changes from 5 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 40 additions & 1 deletion docs/syntax/links.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,13 @@
# Links

A markdown link looks like this:
A Markdown link looks like this:

```markdown
[Link text](destination.md)
```

It has two components:

- Link **text** enclosed in square brackets `[ ]`
- Link **destination** enclosed in parentheses `( )`

Expand Down Expand Up @@ -133,6 +135,43 @@ You can also auto-generate text for specific headings within files:
<!-- Uses the "Configuration" section title from current file -->
```

## Reference-style links

`docs-builder` supports reference-style links.

::::{tab-set}

:::{tab-item} Output

- [Link]
- [Your own text][Link2]

... References are typically added at the bottom of the page ...

[Link]: https://elastic.co
[Link2]: https://elastic.co/docs

:::

:::{tab-item} Markdown

```markdown
- [Link]
- [Your own text][Link2]

... References are typically added at the bottom of the page ...

[Link]: https://elastic.co
[Link2]: https://elastic.co/docs
```

:::


::::

Reference-style links are useful when adding links to tables, for example, or to update frequently used links more easily.

## Legacy features

### Inline anchors
Expand Down
Loading