What is the difference between inline links and reference links?

Inline links place the destination URL directly after the anchor text inside parentheses (`[text](url)`). Reference-style links keep the URL at the bottom of the document using an ID tag (`[text][id]`), keeping the paragraph text cleaner and easier to read in raw plain text.

How do I add a tooltip (title attribute) to a Markdown link?

Add the tooltip text in quotes inside the parentheses following the URL: `[Oyma](https://www.getoyma.com "Private Mac Notes")`. When readers hover over the link in a browser, the tooltip text displays.

What are autolinks in Markdown?

Autolinks allow writing bare URLs wrapped in angle brackets (` `). CommonMark automatically converts them into clickable hyperlinks with the URL as both text and destination.

How do standard Markdown links differ from [[WikiLinks]] in Oyma?

Standard Markdown links connect to external web URLs or relative file paths (`[Doc](guide.md)`). Bidirectional `[[WikiLinks]]` (`[[Project Plan]]`) link notes across your vault without needing file extensions, automatically resolving renames and backlinks.

Markdown Links: Inline, Reference & Auto Link Guide

Primary SyntaxCommonMark

[Anchor text](https://example.com)
[Reference text][ref]
<https://example.com>

Hyperlinks are the fabric of the web and the foundation of interconnected knowledge. In Markdown, linking allows connecting ideas across external websites, referencing internal files, citing academic sources, and building web documentation.

CommonMark provides three distinct linking patterns: inline links, reference-style links, and autolinks. In Oyma, these standard web links coexist seamlessly alongside bidirectional [[WikiLinks]].

Inline links syntax (Most common)

The inline link is the standard way to create hyperlinks in Markdown. Enclose the anchor text in square brackets ([...]), followed immediately by the target URL inside parentheses ((...)):

Visit the [Oyma website](https://www.getoyma.com) to join the Mac beta.

Adding link titles (Tooltips)

You can specify an optional hover tooltip by placing a title string in quotation marks after the URL, separated by a space:

Download [Oyma](https://www.getoyma.com "Private Markdown notes for Mac").

When rendered to HTML, this produces <a href="https://www.getoyma.com" title="Private Markdown notes for Mac">Oyma</a>.

Reference-style links (For clean plain text)

When writing long paragraphs containing multiple complex URLs, inline links can make raw Markdown difficult to read. Reference-style links separate the anchor text from the destination URL:

Oyma provides [sovereign local notes][1], [botless meeting capture][2],
and [on-device transcription][3] on Apple Silicon.

[1]: https://www.getoyma.com/features/local-only-mode "Local storage"
[2]: https://www.getoyma.com/features/meeting-recording-no-bot "Zero bot capture"
[3]: https://www.getoyma.com/features/live-transcription "Whisper transcription"

Named references

Instead of numeric indexes, you can use descriptive identifiers:

Read the [architecture whitepaper][arch-doc] for security details.

[arch-doc]: https://www.getoyma.com/privacy-architecture

Reference link definitions can be placed anywhere in the document—typically at the very bottom. They do not render visibly in the output.

Autolinks syntax

To make a bare URL or email address clickable without defining custom anchor text, wrap it in angle brackets (<...>):

Visit our site at <https://www.getoyma.com> or email <support@getoyma.com>.

In GitHub Flavored Markdown (GFM) and Oyma, bare URLs (e.g., https://www.getoyma.com) are automatically detected and converted into clickable links even without angle brackets.

Relative links to local vault files

You can link to other local Markdown files or media assets using standard relative file paths:

Review the [deployment runbook](./runbooks/deploy.md).
See the attached screenshot: [Error log](./assets/screenshot.png).

Standard links vs [[WikiLinks]] in Oyma

While standard Markdown links are ideal for web URLs and external documentation, internal note linking in Oyma is typically faster using bidirectional [[WikiLinks]]:

Feature	Standard Markdown Link	Bidirectional [[WikiLink]]
Syntax	`[Title](path/note.md)`	`[[Note Title]]` or `[[Target
Target	Web URLs & file paths	Vault notes, headings, and blocks
File extension	Required for local files (`.md`)	Omitted (automatically resolved)
Rename resilience	Links break if destination moves	Automatically rewritten on note rename
Backlinks tracking	Not tracked	Automatically populated in backlinks inspector

Both formats work interchangeably in Oyma. You can write standard [links](url) for external research and [[WikiLinks]] for your internal knowledge graph.

Frequently asked questions

What is the difference between inline links and reference links?: Inline links place the destination URL directly after the anchor text inside parentheses (`[text](url)`). Reference-style links keep the URL at the bottom of the document using an ID tag (`[text][id]`), keeping the paragraph text cleaner and easier to read in raw plain text.
How do I add a tooltip (title attribute) to a Markdown link?: Add the tooltip text in quotes inside the parentheses following the URL: `[Oyma](https://www.getoyma.com "Private Mac Notes")`. When readers hover over the link in a browser, the tooltip text displays.
What are autolinks in Markdown?: Autolinks allow writing bare URLs wrapped in angle brackets (``). CommonMark automatically converts them into clickable hyperlinks with the URL as both text and destination.
How do standard Markdown links differ from [[WikiLinks]] in Oyma?: Standard Markdown links connect to external web URLs or relative file paths (`[Doc](guide.md)`). Bidirectional `[[WikiLinks]]` (`[[Project Plan]]`) link notes across your vault without needing file extensions, automatically resolving renames and backlinks.