Оформление

Ссылки и сноски

Все стили ссылок, переполнение, размещение адресов и отсутствующие сноски.

Отображение ссылок

`--link-style`	Алиас	Результат
`clickable`	`c`	Кликабельный текст через OSC 8 без видимого URL, режим по умолчанию.
`fclickable`	`fc`	Подчёркнутый кликабельный текст через OSC 8.
`inline`	`i`	URL рядом с текстом ссылки.
`inlinetable`	`it`	Нумерованные ссылки и таблица URL после соответствующего текстового блока или таблицы.
`endtable`	`et`	Нумерованные ссылки и таблица URL в конце документа.
`hide`	`h`	Текст ссылки без URL.

Для OSC 8 нужна поддержка гиперссылок терминалом. --color never отключает оформление и OSC 8, сохраняя видимый текст и выбранное представление. --color always сохраняет оформление при передаче через поток.

Отображение ссылок

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

Вывод mdvВерсия 6.1.1

Откройте руководство и примеры.

Продолжайте чтение документа.

Исходный Markdown

Откройте [руководство](https://example.org/guide) и [примеры](https://example.org/examples).

Продолжайте чтение документа.

Переполнение URL

--link-overflow принимает wrap (по умолчанию), cut (сократить длинный URL с ...), tablecut (сокращать в обычном тексте и ячейках таблиц), none (разрешить переполнение). Меняется только видимый адрес, но не назначение гиперссылки.

Длинные адреса

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

Вывод mdvВерсия 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

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

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

Размещение сносок

--footnote-style endnotes собирает определения в конце документа, а attached размещает их сразу после ссылающегося блока, включая абзацы, таблицы и пункты списков. Определения следуют порядку первого использования.

A statement with a source.[^source]

[^source]: Additional information.

Размещение сносок

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

Вывод mdvВерсия 6.1.1

Первое утверждение.[^a]

Другой абзац.

Второе утверждение.[^b]

◇──────────────────────────────────────────────────────────────◇
[^a] Первая сноска.
[^b] Вторая сноска.

Исходный Markdown

Первое утверждение.[^a]

Другой абзац.

Второе утверждение.[^b]

[^a]: Первая сноска.
[^b]: Вторая сноска.

Отсутствующие и пустые определения

--missing-footnote-style show показывает записи-заглушки для отсутствующих, некорректных и пустых определений; это режим по умолчанию. hide исключает их из блока сносок. Необязательный цвет темы footnote_separator управляет разделителями независимо от Markdown-линий.

Отсутствующие определения

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

Вывод mdvВерсия 6.1.1

Утверждение с отсутствующей сноской.[^missing]

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

Исходный Markdown

Утверждение с отсутствующей сноской.[^missing]