How to add external links

Note

This page was written in the style of a How-to Guide according to The Diátaxis Framework.

This guide shows how to include links to pages outside your documentation.

There are two types of files

.rst

In order to link to an external page you have to write `text of your link <your_url>`_. For example, you can link to IBM Quantum documentation by writing:

`IBM Quantum documentation <https://quantum.cloud.ibm.com/docs>`_

Note

You can also use sphinx.ext.intersphinx to link to pages from other project’s documentation using the cross-reference syntax. For more information about cross-referencing and using sphinx.ext.intersphinx, check How to cross-reference to other pages from documentation.

.ipynb

If your file is a Jupyter notebook, what you have to write to link to a page is [text of your link](your_url). If you want to link to IBM Quantum Documentation you can write:

[Qiskit's page](https://quantum.cloud.ibm.com/docs)

Warning

Avoid including backquotes ` as part of the text of your link. Qiskit’s documentation uses nbsphinx to convert the .ipynb files to .rst and then to HTML. So, even though the links will work and look fine in a Jupyter notebook, they will not format properly in the actual documentation because .rst doesn’t admit the backquotes.