Welcome!

Links

Links are essential to any document or presentation, allowing you to reference other sources and provide additional information to your audience. In Markdown, you can easily create links to other websites, files, or even other sections of your presentation.

In a Lupo video a link is only styled text. Each slide is rendered to a still image and joined with its narration, so nothing in the video is clickable, and a link to another part of the deck cannot be followed. Links work only in the slide exports (PDF and HTML) that Lupo produces when slides: true is set in toc.yml (see Table of Contents (TOC)). If viewers need an address, put it on the slide as text they can read.


To create an inline link in Markdown, use the following syntax:

[link name](link)

For example:

[Lupo](https://lupo.ai/)

Lupo


In addition to creating inline links, you can create reference-style links in Markdown. Reference-style links allow you to separate the link text from the URL, making your Markdown more organized and easier to read.

To create a reference-style link, use the following syntax:

[link name][id]
[id]: link "mouseover text"

For example:

[Lupo][lupo]
[lupo]: https://lupo.ai/ "Go to Lupo"

Lupo

url with mouseover text

lupo

The link definition includes the link URL and optional title or tooltip, which can be placed anywhere after a blank line but is generally near the bottom. Definition identifiers, such as [id], may consist of letters, numbers, spaces, and punctuation and are not case-sensitive.


Relative URLs

Markdown also accepts a relative URL: a path from the current document to another file. For example, if you have a file called image.png in the same directory as your Markdown document, this is a link to it:

[Image](image.png)

In a Lupo slide this is not useful. Lupo resolves relative paths for images and videos before it builds, but it does not touch the target of a link, so in the exported slides the link points at a file that is not there, and in the video it is only text. Use a full https:// URL when you link to something.


Example with References

Here's an example of using reference-style links with references:

[hurricane]: https://en.wikipedia.org/wiki/Hurricane_Erika "Hurricane Erika"
[Hurricane][hurricane] Erika was the strongest and longest-lasting tropical cyclone in the 1997 Atlantic [hurricane] season.

Hurricane Erika was the strongest and longest-lasting tropical cyclone in the 1997 Atlantic hurricane season.