skip to main content
Authoring Source Documents » Markdown++ Source Documents » Learning Markdown » Links
Links
Links are an inline Markdown convention used to connect users to other locations and resources in a set of information.
Syntax
Link syntax looks interesting, but is simple enough once written a few times. Write the link's displayed text in between [ and ] characters, and directly next to it write the link's URL between ( and ) characters. Optionally, a title can be given to the Link, written next to the link URL, separated by a space and wrapped in " characters.
Basics
A basic Link example.
[Link Text](path/to/my_doc.md)
Titles are optional. Keep the URL and title separate with a space. Wrap the title in " characters.
[Link Text](path/to/my_doc.md "Link Title")
Links can be the only thing on a line or mixed in anywhere inline text can go.
To see more, follow the [Link](path/to/my_doc.md).
Relative paths, absolute paths, web links, and Aliases are all valid path values.
[Link Text](../my_doc.md)

[Link Text](D:/Markdown/Docs/my_doc.md)

[Link Text](https://www.webworks.com)

[Link Text](#my-doc)
Using Link References
Links can make use of Link References to simplify URL management for documents with many different link paths.
[Link Text][0]

[0]: my_image.png
Titles are also available and written the same way using Link References.
[Link Text][0]

[0]: my_image.png "Link Title"
Markdown++
A custom Character Style can be given to an Image using a Markdown++ style tag immediately before the Link syntax.
<!--style:CustomLink-->[Link Text](path/to/my_doc.md)
To learn more about Markdown++ tagging, see Learning Markdown++.
Link Behavior
Links in ePublisher have a variety of ways to connect to other resources in a publication. What they connect to depends on what is used as a path value. All path values inside links also apply to path values in Link References.
Web Links
Write a fully qualified web URL in the path area to link to an external resource. Make sure to start the URL with http:// or https://.
[WebWorks Website](https://www.webworks.com)
Link to Other Documents
Write the file path for the intended file in the path area to link to another document. Relative paths need to resolve from the file the link is written in. Absolute paths can also be used.
[link text](path/to/my_doc.md)
[link text](C:/Users/me/path/to/my_doc.md)
Link to Topics in Other Documents
To link to a specific section in a document, write the file path followed immediately with the alias for the topic. This can be either a Heading Alias or a Custom Alias. Relative paths need to resolve from the file the link is written in. Absolute paths can also be used.
The examples link to the alias #my-alias in my_doc.md.
[link text](path/to/my_doc.md#my-alias)
[link text](C:/Users/me/path/to/my_doc.md#my-alias)
Link to Topics in Same Document
Use an alias by itself to link to a topic in the current document. This can be either a Heading Alias or a Custom Alias.
The example links to the alias #my-alias in the current document.
[link text](#my-alias)
ePublisher Style Information
Default Style Properties
Style Type: Character
Style Name: Link
Property
Value
text decoration
underline
color
#0078d7
If a custom style name is assigned to a Link, that style name will still inherit all of the listed default style information.
Was this helpful?
Last modified date: 11/15/2024