////
Included in:

- user-manual: relative links
- writers-guide
////

If you want to link to an external file relative to the current document, use the `link` macro in front of the file name.

[source]
----
include::ex-url.adoc[tag=link]
----

If your file is an HTML file, you can link directly to a section in the document, append a hash (`#`) followed by the section's ID to the end of the file name.

[source]
----
include::ex-url.adoc[tag=hash]
----

////
You can also create links that refer to sections within the current document.

[source]
----
link:user-manual.html[URLs]
----

====
link:user-manual.html[URLs]
====
////