Links, footnotes and pictures

[text](https://example.com "title"), <https://example.com>, https://example.com

[see the intro](#the-intro)

A claim.[^1]

[^1]: The source.

![A caption](report-assets/chart.png "title")

# Links, footnotes and pictures

Each section gives the syntax in one example, links to the full syntax, and says what Wymark does with it. Where it is on the toolbar and its shortcut are in the [constructs table](/docs/reference/markdown#constructs).

## Links

```markdown
[text](https://example.com "title"), <https://example.com>, https://example.com
```

Full syntax: [links on markdownlang.com](https://www.markdownlang.com/basic/links.html).

- Inline, reference (`[text][label]` with `[label]: url`), angle and bare. A bare URL is always a link outside a code span. A definition nothing cites is marked unused.
- A typed URL becomes a link when you finish it with a space, `↩` or a full stop.
- `⌘K` or Insert > Link opens the link dialog over a selection, with the text filled in.
- Click into a link to edit its destination in place. The popup also has an eraser that keeps the text and drops the link.
- A plain click puts the caret in the link. **`⌘`-click follows it.**

| `⌘`-click on | Opens |
| --- | --- |
| A web link | Your browser. |
| A link to a markdown file in your folder | That file in the other pane, splitting the editor if there is only one, at the `#heading` if the link names one. |
| A link to a heading in this document | That heading. |

## Heading links

```markdown
[see the intro](#the-intro)
```

Every heading is a link target. The anchor is made from the heading's text by GitHub's rules, so the same link works on GitHub and in Word and PDF exports. Nothing is written into the file.

- **Copy one:** open the Outline tab, hover a heading, click the link icon. The clipboard gets `[Getting started](#getting-started)`.
- A link that matches no heading does nothing and is not marked. The usual cause is a heading renamed after the link was written.

| Heading | Anchor |
| --- | --- |
| `## Getting started` | `#getting-started` |
| `## Café & Crème` | `#café--crème` |
| `## 1. Introduction` | `#1-introduction` |
| `## Hello, World!` | `#hello-world` |
| Second `## Notes` | `#notes-1` |

Letters are lowercased, spaces become hyphens, punctuation is removed, formatting is ignored, accented and non-Latin letters are kept. GitHub states the same rules in [its docs](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#section-links).

> [!NOTE]
> `## Heading {#my-id}` is read as part of the title, as on GitHub, unless Settings > Appearance > Custom heading IDs is on. Then the braces hide until the caret enters the heading and `#my-id` is the anchor. Turn it on if you publish with Jekyll, Hugo, Pandoc or kramdown; elsewhere the braces show as text. The setting changes how the file is read; Wymark never adds, removes or rewrites the braces. Full syntax: [heading IDs on markdownlang.com](https://www.markdownlang.com/extended/heading-ids.html).

| Export | A heading link becomes |
| --- | --- |
| Word | A cross-reference to the heading's bookmark. |
| PDF | A link annotation. |

In a Word export with tracked changes, a heading that changed in that export has no anchor.

`<a name="..."></a>` is not an anchor in Wymark. It stays raw HTML, and links to it do not jump.

## Footnotes

```markdown
A claim.[^1]

[^1]: The source.
```

Full syntax: [footnotes on markdownlang.com](https://www.markdownlang.com/extended/footnotes.html).

- `[^label]` and `[^label]: text`, anywhere in the document. A definition stays where you wrote it. Why is on the [diff page](/docs/how-it-works/diff).
- `[^label]:` at the start of a line starts a footnote. `↩` leaves it.
- Typing `[^` lists the document's footnotes, for citing one again.
- Hover a reference to read the note. `⌘`-click it to jump there. The note ends with one `↩` per place that cites it.
- A footnote in the Formatted view is one paragraph. Write a longer one, or rename a label, in the Source view.
- A reference with no definition is shown as text, with a warning.

## Pictures

```markdown
![A caption](report-assets/chart.png "title")
```

Full syntax: [images on markdownlang.com](https://www.markdownlang.com/basic/images.html).

- `![alt](path "title")`, reference-form pictures, and `<img>` with `src`, `alt`, `title`, `width`, `height`.
- Paste a screenshot, or Insert > Image (`⌃⌘I`) with a URL, a relative path, or Browse.
- A pasted picture is saved in a folder beside the document (`report.md` gets `report-assets/`; Settings > Images changes the pattern) and linked by a relative path.
- Drag the handle to resize. The file then gets `<img src="..." width="...">`, because markdown has no size syntax.
- A picture that cannot be found shows a box naming its path. Double-click to fix the path.

See also [Diagrams](/docs/reference/diagrams), [Drawings](/docs/reference/drawings) and `<figure>` and `<picture>` on the [HTML](/docs/reference/html) page.