# Links

There are a few links you can use with different purposes.

| Link type                         | Markup                                                           | Renders as                                                                    | Description                                                                                                                                                 |
|-----------------------------------|------------------------------------------------------------------|-------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
| External Link                     | ```rst<br/>`External Link <https://docs.scylladb.com/>`_<br/>``` | [External Link](https://docs.scylladb.com/)                                   | Use this markup to create a link to another site or project. When rendered it has an arrow pointing out icon. It opens the content in a new tab.            |
| Internal Cross-reference          | ```rst<br/>:ref:`Internal Link <here>`<br/>```                   | [Internal Link](#here)                                                        | This is an internal cross reference. It requires a bookmark. Content opens in the same tab.                                                                 |
| Internal Cross-reference Bookmark | ```rst<br/>.. _here:<br/>```                                     | <a id="here"></a>                                                             | This is an internal cross reference bookmark. It requires an internal cross-reference anchor (above). It does not render, but serves as a point to link to. |
| Internal Doc Reference            | ```rst<br/>:doc:`Internal Doc <../index>`<br/>```                | [Internal Doc](https://sphinx-theme.scylladb.com/branch-1.5/index.md)         | This is an internal doc cross reference. it looks for a file. A full path is required.                                                                      |
| Download Link                     | ```rst<br/>:download:`download <index.rst>`<br/>```              | [`download`](https://sphinx-theme.scylladb.com/branch-1.5/examples/index.rst) | This opens a download window. It is used to help users download software or files.                                                                          |
