---
title: "External links"
manual: "How to Document"
version: "main"
permalink: "https://docs.typo3.org/permalink/h2document:external-links"
source: "Reference/ReStructuredText/Links/ExternalLinks.rst"
rendered: "2026-09-19T10:25:29+00:00"
---

# External links {#external-links}

> [!IMPORTANT]
> Do not use this mechanism (external links) for links to sections of
> the TYPO3. Use references as described in the section above:
> [References to TYPO3 manuals](https://docs.typo3.org/permalink/h2document:rest-reference).

An URL that is mentioned within a text is automatically linked:

```rst
Lorem Ipsum Dolor https://example.org dolor sit
```

The result looks like this:

Lorem Ipsum Dolor [https://example.org](https://example.org) dolor sit

If you want to also give the URL a distinctive link text you can use the
following syntax:

```rst
Lorem Ipsum Dolor `Example Page <https://example.org>`__ dolor sit
```

The result looks like this:

Lorem Ipsum Dolor [Example Page](https://example.org) dolor sit

Sometimes links can get quite long and unruly to use within the text. You can
use so called named links to separate the link definitions from the text:

```rst
Lorem Ipsum Dolor `Example Page`_ dolor sit

..  _Example Page: https://example.org
```

The result looks like this:

Lorem Ipsum Dolor [Example Page](https://example.org) dolor sit