Smart link

A smart link is a link that shows what it points at. Instead of a bare address, readers see the page’s own title and, as a card, its description, picture and site name, fetched from that page. Use one when the link is the point: an article everyone should read, the design doc a decision rests on, the home page of a tool the team uses.

Insert it

Type the command at the start of a line, or after a space, and press Enter. Or choose + on the toolbar, then Smart link. If you had text selected, the smart link takes its place.

Paste the address into the box and press Enter, or choose Show. It starts as a card.

Card or inline

Card

A block of its own, with the page’s picture, title, description and site. Use it when the link deserves attention of its own, such as recommended reading at the end of a section:

Big Buck Bunny - Wikipediaen.wikipedia.org

Inline

The page’s title as a link, inside a sentence, with a small arrow after it. Use it when the link is part of what you are saying:

Compared with an ordinary link

The same address as an ordinary link reads as whatever words you give it, such as this article on wikis. Use an ordinary Link for links in running text you want to word yourself, and a smart link when the page’s own title says it best.

Your Tesria server fetches the title and picture from the page. If it cannot, because the site does not allow it or the server cannot reach the internet, the link still works and shows its address instead.

Changing and removing it

• A card: click it while you are editing. The address box appears above it, with Update to change the address, and Card and Inline to switch. Inline puts the link in a line of its own, where you can type around it.

• An inline link: click it for its address, Update, and Card, which turns it into a card below its paragraph.

• To remove either, click it to select it and press Delete.

Good practice

• Cards for a few links that matter, not for every link: a page of cards is hard to read.

• Say why it is worth opening in a sentence beside it.

Related elements

• Link turns any words into a link.

• Embed shows the page itself inside yours, for sites that allow it.