Formatting

Links and footnotes

All link styles, overflow modes, reference placement and missing footnotes.

Link presentation

`--link-style`	Alias	Result
`clickable`	`c`	Clickable text using OSC 8, without a visible URL; the default.
`fclickable`	`fc`	Underlined clickable text using OSC 8.
`inline`	`i`	The URL beside the link text.
`inlinetable`	`it`	Numbered links and a URL table after their owning text block or table.
`endtable`	`et`	Numbered links and a URL table at document end.
`hide`	`h`	Link text without its URL.

OSC 8 links need terminal hyperlink support. --color never disables generated terminal styling and OSC 8; visible text and the selected presentation remain. --color always preserves styling through a pipeline.

Link presentation

mdv --no-config --theme catppuccin --cols 64 --link-style clickable example.md

mdv outputVersion 6.1.1

Open the guide and examples.

Keep reading the document.

Markdown source

Open the [guide](https://example.org/guide) and [examples](https://example.org/examples).

Keep reading the document.

URL overflow

--link-overflow accepts wrap (the default), cut (shorten long URLs with ...), tablecut (shorten in normal text and table cells), or none (allow overflow). It changes the visible URL, never the hyperlink destination.

Long URLs

mdv --no-config --theme catppuccin --cols 40 --link-style inline --link-overflow wrap example.md

mdv outputVersion 6.1.1

Documentation(https://example.org/docume
ntation/terminal/formatting/links-and-fo
otnotes)

 Page  │ Link                           
───────┼────────────────────────────────
 Guide │ Open(https://example.org/docum 
       │ entation/terminal/formatting/l 
       │ inks-and-footnotes)

Markdown source

[Documentation](https://example.org/documentation/terminal/formatting/links-and-footnotes)

| Page | Link |
| --- | --- |
| Guide | [Open](https://example.org/documentation/terminal/formatting/links-and-footnotes) |

Footnote placement

--footnote-style endnotes collects definitions at document end; attached places them immediately after the referencing block, including paragraphs, tables and list items. Definitions follow first-use order.

A statement with a source.[^source]

[^source]: Additional information.

Footnote placement

mdv --no-config --theme catppuccin --cols 64 --footnote-style endnotes example.md

mdv outputVersion 6.1.1

First statement.[^a]

Another paragraph.

Second statement.[^b]

◇──────────────────────────────────────────────────────────────◇
[^a] First note.
[^b] Second note.

Markdown source

First statement.[^a]

Another paragraph.

Second statement.[^b]

[^a]: First note.
[^b]: Second note.

Missing and empty definitions

--missing-footnote-style show displays placeholder entries for missing, invalid or empty definitions; it is the default. hide omits those entries from the footnote block. The optional theme color footnote_separator controls separators independently from Markdown rules.

Missing definitions

mdv --no-config --theme catppuccin --cols 64 --missing-footnote-style show example.md

mdv outputVersion 6.1.1

A statement with a missing note.[^missing]

◇──────────────────────────────────────────────────────────────◇
[^missing] Missing footnote definition

Markdown source

A statement with a missing note.[^missing]