Links in HTML export (The Org Manual)

Next: Tables in HTML export, Previous: Headlines in HTML export, Up: HTML Export [Contents][Index]

#### 13.9.7 Links in HTML export

The HTML export back-end transforms Org’s internal links (see Internal Links) to equivalent HTML links in the output. The back-end similarly handles Org’s automatic links created by radio targets (see Radio Targets) similarly. For Org links to external files, the back-end transforms the links to relative paths.

For Org links to other ‘`.org`’ files, the back-end automatically changes the file extension to ‘`.html`’ and makes file paths relative. If the ‘`.org`’ files have an equivalent ‘`.html`’ version at the same location, then the converted links should work without any further manual intervention. However, to disable this automatic path translation, set `org-html-link-org-files-as-html` to `nil`. When disabled, the HTML export back-end substitutes the ID-based links in the HTML output. For more about linking files when publishing to a directory, see Publishing links.

Org files can also have special directives to the HTML export back-end. For example, by using ‘`#+ATTR_HTML`’ lines to specify new format attributes to `<a>` or `<img>` tags. This example shows changing the link’s title and style:

    #+ATTR_HTML: :title The Org mode homepage :style color:red;
    [[https://orgmode.org]]