Embedding Links

You can embed links into document content in several ways:

  • Using the Link Dialog (ctrl-k)
  • Using inline text linking (ctrl-shift-k)
  • Using raw Markdown Syntax
  • Using raw HTML Syntax

You can use the Link Dialog by clicking on the on the toolbar. The Paste Link dialog lets you interactively create a link to paste into your content. Here's what the dialog looks like:

Although this is a UI dialog the flow through dialog is very quick using shortcut keys (Ctrl-K, Enter or Ctrl-K, type link Enter) as the dialog automatically populates the link text and URL if one is on the clipboard.

For the Link you can either type in or paste a URL or use the file selection button pick a local file resource to link. Any local file resources will be linked as relative if possible.

Automatic URL Embedding from Clipboard

If you have a URL on the clipboard when the dialog is first opened, the URL is automatically placed into the Link field. This also applies to the Inline Link Shortcut operation below.

If you navigate off the form and copy a URL to your clipboard then return to the form, if the Link field is still empty it is then automatically filled from the Clipboard URL.

If you don't like to use a UI form to pop up you can get similar behavior with ctrl-shift-k key combo which creates a link from the current selection of text and directly injects the markdown into the page. It fills the text part and if a URL is on the clipboard fills that into the link part. If not the cursor is placed into the link area for you to fill in the link.

It's a quick way to get a link into the page from selected text.

Using Raw Markdown

Of course you can also manually type the raw markdown text for a link. To embed links into a topic you can either use the markdown syntax like this:

[Go to the Support Web Site](https://support.west-wind.com)

or for local links using relative paths:

[Download Page](./product/download.html)

HTML Syntax

Markdown also supports raw HTML so you can also use raw HTML text to embed links. This is useful if you require target links or need to add alignment styling.

<a href="./product/download.html" target="_top">Download Page</a>

© West Wind Technologies, 1996-2020 • Updated: 06/01/20
Comment or report problem with topic