Skip to content

[Sync to prerelease] docs(html-basics.qmd): make description consistent with link-external-filter example code #2119

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
cderv merged 1 commit into from
Jul 24, 2026
+13 −13
Merged

[Sync to prerelease] docs(html-basics.qmd): make description consistent with link-external-filter example code #2119

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
26 changes: 13 additions & 13 deletions docs/output-formats/html-basics.qmd
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -344,19 +344,19 @@ format:

By default external links (i.e. links that don't target the current site) receive no special visual adornment or navigation treatment (the current page is navigated). You can use the following options to modify this behavior:

+---------------------------+--------------------------------------------------------------------------------------------------------------------+
| Option | Description |
+===========================+====================================================================================================================+
| `link-external-icon` | `true` to show an icon next to the link to indicate that it's external (e.g. [external](#){.external}). |
+---------------------------+--------------------------------------------------------------------------------------------------------------------+
| `link-external-newwindow` | `true` to open external links in a new browser window or tab (rather than navigating the current tab). |
+---------------------------+--------------------------------------------------------------------------------------------------------------------+
| `link-external-filter` | A regular expression that can be used to determine whether a link is an internal link. For example |
| | |
| | `^(?:http:|https:)\/\/www\.quarto\.org\/custom` |
| | |
| | will treat links that start with http://www.quarto.org as internal links (and others will be considered external). |
+---------------------------+--------------------------------------------------------------------------------------------------------------------+
+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Option | Description |
+===========================+================================================================================================================================================================+
| `link-external-icon` | `true` to show an icon next to the link to indicate that it's external (e.g., [external](#){.external}). |
+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| `link-external-newwindow` | `true` to open external links in a new browser window or tab (rather than navigating the current tab). |
+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| `link-external-filter` | A regular expression that can be used to determine whether a link is an internal link. For example |
| | |
| | `^(?:http:|https:)\/\/www\.quarto\.org\/custom` |
| | |
| | will treat links that start with `http://www.quarto.org/custom` or `https://www.quarto.org/custom` as internal links (and others will be considered external). |
+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+

External links are identified either using the `site-url` (if provided) or using the `window.host` if no `site-url` or `link-external-filter` is provided. For example, here we enable both options and a custom filter:

Expand Down