Links and references
In semantic markup, to create a link to another topic, to an anchor inside a topic, or the external resource, use
The link text may contain text with inline formatting, shortcuts, UI paths, controls, and images.
Specify the topic ID for internal reference or the page URL for external.
Refer to a specific element ID or anchor element on the page.
[true|false]By default, we check that links are valid and lead to either topic, anchor, or an existing external resource. If
true, the link won't be validated and will be considered plain text.
Specify a summary to display when hovering over a link.
Specify how to display title: title case, sentence case, all upper letters, all lower letters, or as written.
Specify a unique identifier to use as a link anchor and generate a meaningful URL for this link. You can reference and reuse any element that has an ID.
Define a set of custom filters for conditionally including this link.
Define a set of instances for conditionally filtering this link.
Make this link switchable depending on the selected key.
Specify which topic variant to open first when you point to the topic with sections.
If no text is specified for an internal link, we will display the topic title instead. For external, we will display an address.
Markdown uses the following markup for links:
Press Alt+Insert to open the Insert menu, and then select Link, or press Ctrl+Shift+U to generate a Markdown link. If you previously copied a URL to the clipboard, Writerside will insert the URL as the target of the link.
A link can reference an external URL, another topic file (as long as it's in the same help instance), or any element with an ID, which creates an anchor on the page.
A chapter in Markdown has a default ID based on the header. To assign a custom ID to any element, specify
To define the link summary, specify it in quotes after the link target:
Reference-style links in Markdown
In Markdown, you can use reference-style links to insert them multiple times within a topic. To do this, you need to declare the link inside that topic with a reference name and reference the link by this name:
<seealso> element to add a section at the bottom of the page with links that may be related to this topic.
See how this section looks at the bottom of the current page. You can set
<seealso style="cards"> to render related links as cards instead of a list of links.
Here is an example of the c.list file: