Полный справочник CLI

--html

Печать HTML вместо терминального форматирования.

--render-html

-E, --render-html

Рендер встроенных HTML-фрагментов как форматированного терминального содержимого вместо буквального показа тегов.

• Вложенность HTML ограничена 64 DOM-элементами.

mdv --no-config --theme catppuccin --cols 64 example.md

<details>
<summary>Подробности</summary>
<p><strong>Оформленный</strong> абзац.</p>
</details>

<details>
<summary>Подробности</summary>
<p><strong>Оформленный</strong> абзац.</p>
</details>

--line-numbers

-N, --line-numbers [<MODE>]

Добавление номеров строк в терминальный вывод и pager.

• Без режима нумеруются отрендеренные строки
• source использует физические строки Markdown
• separator добавляет разделитель
• "source;separator" сочетает оба режима.

mdv --no-config --theme catppuccin --cols 64 example.md

 Пример
  
  Длинный абзац переносится на несколько строк вывода при выбран
  ной ширине терминала.
  
  Последний абзац.

## Пример

Длинный абзац переносится на несколько строк вывода при выбранной ширине терминала.

Последний абзац.

--color

--color <auto|always|never>

Управление терминальным оформлением.

• auto включает ANSI и OSC 8 только при выводе в терминал
• always сохраняет оформление в pipe
• never выводит отрендерированный текст без оформления.

mdv --no-config --theme catppuccin --cols 64 --color always example.md

Курсив, жирный текст, оба.

Строчный `код`, удалённый и выделенный текст.

*Курсив*, **жирный текст**, ***оба***.

Строчный `код`, ~~удалённый~~ и ==выделенный== текст.

--color-depth

--color-depth <auto|16|256|truecolor>

Автоматическое определение палитры терминала или её явное ограничение.

• Действует на цвета документа и интерактивного интерфейса; по умолчанию auto.

mdv --no-config --theme catppuccin --cols 64 --color-depth 16 example.md

Пример
 
 Читайте Markdown через `mdv`.
 
 ╭─ Note ────────────────────────╮
 │ Пример документа в терминале. │
 ╰───────────────────────────────╯
 
   fn main() {
       println!("hello, mdv");
   }
 
 Откройте руководство.

# Пример

Читайте **Markdown** через `mdv`.

> [!NOTE]
> Пример документа в терминале.

```rust
fn main() {
    println!("hello, mdv");
}
```

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

--hide-comments

Скрытие Markdown-комментариев в итоговом выводе.

mdv --no-config --theme catppuccin --cols 64 example.md

Видимый текст.

<!-- Внутренний комментарий. -->
Другой текст.

Видимый текст.

<!-- Внутренний комментарий. -->

Другой текст.

--front-matter

--front-matter <hidden|panel|table|plain|inline|blocks|code|source>

Управление YAML-словарём свойств с точными разделителями ---, начинающимся с первой строки.

• hidden скрывает его
• panel показывает панель свойств
• table выводит колонки «Property» и «Value»
• plain - нормализованные строки «ключ: значение»
• inline объединяет свойства в одну переносимую строку
• blocks помещает значение под ключом
• code выводит YAML с подсветкой
• source разбирает весь ввод как обычный Markdown.

mdv --no-config --theme catppuccin --cols 64 --front-matter hidden example.md

 Начало
  
  Читайте документ.

---
title: Руководство
author: Alice
tags: [docs, terminal]
---

## Начало

Читайте документ.

--theme-info

--theme-info [FILE]

Показ активной палитры; при указании FILE рендерит документ вместе со сведениями о теме.

--from

--from <TEXT>

Рендер начиная с первой строки, содержащей <TEXT>.

• Добавление :<lines> ограничит число строк (например
• --from "Install:20").

--reverse

-r, --reverse

Рендер документа с конца, сохраняя форматирование блоков.

mdv --no-config --theme catppuccin --cols 64 example.md

 Первый раздел
  
  Первый абзац.
  
  Второй абзац.

 Следующий раздел
  
  Продолжайте чтение.

## Первый раздел

Первый абзац.

Второй абзац.

## Следующий раздел

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

--pager

-p, --pager[=<COMMAND>]

Открыть результат в pager.

• Голый флаг использует MDV_PAGER, если переменная задана, иначе pager по умолчанию.
• --pager=default выбирает backend по умолчанию (сейчас встроенный minus)
• --pager=builtin явно выбирает minus, а команда вроде --pager="less -R" получает отрендерированный вывод через stdin

mdv --no-config --theme catppuccin --wrap word --pager=builtin README.md

                                                                                
Руководство mdv                                                                 
                                                                                
 Читайте Markdown прямо в терминале.                                            
                                                                                
 Установка                                                                      
                                                                                
  Установите mdv и откройте любой Markdown-файл.                                
                                                                                
    cargo install mdv                                                           
    mdv README.md                                                               
                                                                                
 Темы                                                                           
                                                                                
  Выберите тему для документа и интерфейса.                                     
                                                                                
    mdv --theme catppuccin README.md                                            
                                                                                
  Пресеты                                                                       
                                                                                
   Пресет reader включает удобное оформление для чтения.                        
 MDV  README.md                                                      0%  ? Help 

# Руководство mdv

Читайте Markdown прямо в терминале.

## Установка

Установите mdv и откройте любой Markdown-файл.

```sh
cargo install mdv
mdv README.md
```

## Темы

Выберите тему для документа и интерфейса.

```sh
mdv --theme catppuccin README.md
```

### Пресеты

Пресет reader включает удобное оформление для чтения.

## Навигация

Используйте поиск, оглавление и номера строк.

- Найдите нужный раздел.
- Выделите текст для копирования.
- Вернитесь к чтению документа.

## Ссылки

Откройте [документацию](https://example.org/docs).

--interactive

-i, --interactive

Открыть интерактивный браузер документов.

• Каталог открывает выбор документов, а файл или стандартный ввод сразу открывается в выбранном просмотрщике.
• Запуск mdv без аргументов в терминале открывает текущий каталог, а путь к каталогу открывает указанный каталог.
• При перенаправленном выводе браузер автоматически не запускается.
• Браузер рекурсивно находит Markdown-файлы с учётом скрытых путей и .gitignore.

mdv --no-config --theme catppuccin -i docs/

                                                                                
    MDV                                                                         
                                                                                
   8 documents                                                                  
                                                                                
 │ CHANGELOG.md                                                                 
 │ 8 hours ago                                                                  
                                                                                
   README.md                                                                    
   1 hour ago                                                                   
                                                                                
   examples/code.md                                                             
   6 hours ago                                                                  
                                                                                
   examples/tables.md                                                           
   7 hours ago                                                                  
                                                                                
                                                                                
   ••                                                                           
                                                                                
   h/l ←/→ page • / find • . show ignored • r refresh • e edit • q quit • …     
                                                                                

docs/
  README.md
  guides/installation.md
  guides/themes.md
  guides/presets.md
  guides/navigation.md
  examples/code.md
  examples/tables.md
  CHANGELOG.md

--monitor

Наблюдение за файлом и автоматический перерендер при изменениях.

--config-file

-F, --config-file <CONFIG_DIR>

Чтение настроек из указанного каталога.

--preset

-P, --preset <NAME>

Применение встроенного или пользовательского пресета поверх конфигурационного файла и до явных параметров CLI.

mdv --no-config --cols 64 example.md

Пример
 
 Читайте Markdown через `mdv`.
 
 ╭─ Note ────────────────────────╮
 │ Пример документа в терминале. │
 ╰───────────────────────────────╯
 
   fn main() {
       println!("hello, mdv");
   }
 
 Откройте руководство.

# Пример

Читайте **Markdown** через `mdv`.

> [!NOTE]
> Пример документа в терминале.

```rust
fn main() {
    println!("hello, mdv");
}
```

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

--preset-info

Вывод списка доступных пресетов, если позиционный FILE не указан.

• Команда mdv --preset-info FILE --preset NAME рендерит документ и печатает Current preset: NAME; с FILE, но без --preset, флаг не меняет рендеринг.

--no-config

-n, --no-config

Игнорирование config.yaml/config.yml; пресеты остаются доступными.

--init-config

--init-config [CONFIG_DIR]

Создание конфигурационного файла по умолчанию.

• Используется указанный каталог
• --config-file
• MDV_CONFIG_PATH или каталог по умолчанию.

--theme

-t, --theme <NAME>

Выбор встроенной или пользовательской темы (по умолчанию terminal).

mdv --no-config --theme terminal --cols 64 example.md

Пример
 
 Читайте Markdown через `mdv`.
 
 ╭─ Note ────────────────────────╮
 │ Пример документа в терминале. │
 ╰───────────────────────────────╯
 
   fn main() {
       println!("hello, mdv");
   }
 
 Откройте руководство.

# Пример

Читайте **Markdown** через `mdv`.

> [!NOTE]
> Пример документа в терминале.

```rust
fn main() {
    println!("hello, mdv");
}
```

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

--code-theme

-T, --code-theme <NAME>

Отдельная палитра подсветки кода.

• Без явного выбора код использует палитру темы документа.

mdv --no-config --theme catppuccin --cols 64 --code-theme terminal example.md

  fn main() {
      println!("hello, mdv");
  }

```rust
fn main() {
    println!("hello, mdv");
}
```

--syntaxes-dir

--syntaxes-dir <DIR>

Рекурсивная загрузка пользовательских .sublime-syntax поверх встроенного набора.

• Пользовательские определения имеют приоритет при совпадении со встроенными.

--code-block-style

-b, --code-block-style <basic|simple|pretty>[:show-name;show-icon]

Стиль оформления блоков кода: безрамочный блок с отступом, одинарная граница или полная рамка.

• По умолчанию подпись скрыта
• show-name показывает название языка
• show-icon - его иконку, обе опции можно комбинировать (по умолчанию basic).

mdv --no-config --theme catppuccin --cols 64 --code-block-style basic example.md

  fn main() {
      println!("hello, mdv");
  }

```rust
fn main() {
    println!("hello, mdv");
}
```

mdv --no-config --theme catppuccin --cols 64 --code-block-style pretty example.md

╭─────────────────────────────╮
│ fn main() {                 │
│     println!("hello, mdv"); │
│ }                           │
╰─────────────────────────────╯

```rust
fn main() {
    println!("hello, mdv");
}
```

--math-block-style

--math-block-style <basic|simple|pretty>

Стиль display-формул и fenced-блоков math/latex/tex.

mdv --no-config --theme catppuccin --cols 64 --math-block-style basic example.md

   a+b
   ─── = √(x² + 1)
    c

$$
\frac{a+b}{c} = \sqrt{x^2 + 1}
$$

--code-line-numbers

-K, --code-line-numbers [<MODE>]

Нумерация строк внутри каждого блока кода.

• Без режима нумеруется каждая перенесённая терминальная строка
• source нумерует физические строки кода и оставляет продолжения без номера
• separator добавляет разделитель
• "source;separator" сочетает оба режима.

mdv --no-config --theme catppuccin --cols 44 example.md

  fn main() {
      let message = "A long line of code tha
        t wraps to the available terminal wi
        dth";
      println!("{message}");
  }

```rust
fn main() {
    let message = "A long line of code that wraps to the available terminal width";
    println!("{message}");
}
```

--custom-theme

--custom-theme <key=value;...>

Переопределение цветов интерфейса поверх выбранной темы.

mdv --no-config --theme catppuccin --cols 64 example.md

Пример
 
 Читайте Markdown через `mdv`.
 
 ╭─ Note ────────────────────────╮
 │ Пример документа в терминале. │
 ╰───────────────────────────────╯
 
   fn main() {
       println!("hello, mdv");
   }
 
 Откройте руководство.

# Пример

Читайте **Markdown** через `mdv`.

> [!NOTE]
> Пример документа в терминале.

```rust
fn main() {
    println!("hello, mdv");
}
```

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

--inline-style

--inline-style <STYLES>

Переопределение оформления emphasis

• strong
• strong_emphasis
• code
• strikethrough и highlight.
• Записи формата element:property=true,property=false разделяются ;; доступны свойства backticks
• bold
• italic
• underline и strikethrough (например
• --inline-style 'code:backticks=false,bold=true;highlight:underline=true').

mdv --no-config --theme catppuccin --cols 64 example.md

Курсив, жирный текст, оба.

Строчный `код`, удалённый и выделенный текст.

*Курсив*, **жирный текст**, ***оба***.

Строчный `код`, ~~удалённый~~ и ==выделенный== текст.

--custom-code-theme

--custom-code-theme <key=value;...>

Переопределение цветов подсветки кода в том же формате, что и --custom-theme.

mdv --no-config --theme catppuccin --cols 64 example.md

  fn main() {
      println!("hello, mdv");
  }

```rust
fn main() {
    println!("hello, mdv");
}
```

--custom-code-block

--custom-code-block <lang:icon=...,label=...,aliases=...|...>[;...]

Переопределение иконки, подписи и псевдонимов для конкретных языков блоков кода.

• Несколько языков разделяются ;, опции внутри одного языка - ,, а псевдонимы - | (например
• python:icon=*,label=Python,aliases=py|py3;rust:icon=R).
• Работает для любого указанного языка, даже если его нет во встроенной карте иконок.
• Подсветка синтаксиса применяется только к языкам, которые поддерживает текущая логика подсветки mdv.
• Используйте default:icon=..., чтобы задать fallback-иконку для неизвестных языков.

mdv --no-config --theme catppuccin --cols 64 --code-block-style 'pretty:show-name;show-icon' example.md

╭─  Rust ────────────────────╮
│ fn main() {                 │
│     println!("hello, mdv"); │
│ }                           │
╰─────────────────────────────╯

```rust
fn main() {
    println!("hello, mdv");
}
```

--callout-style

-C, --callout-style <pretty|simple>[:show-icons;show-simple-icons;fold-icons;label-inside;uppercase]

Стиль callout-блоков и правила отображения подписи.

• show-icons использует глифы Nerd Font
• show-simple-icons - переносимые ASCII-маркеры вроде [i]
• [*]
• [!] и [x].
• Эти два параметра нельзя комбинировать.
• label-inside поддерживается только с pretty
• fold-icons требует show-icons.

mdv --no-config --theme catppuccin --cols 64 --callout-style pretty example.md

╭─ Note ────────────────────────╮
│ Читайте Markdown в терминале. │
╰───────────────────────────────╯

╭─ Tip ─────────────────────╮
│ Выберите тему для работы. │
╰───────────────────────────╯

> [!NOTE]
> Читайте Markdown в терминале.

> [!TIP]
> Выберите тему для работы.

mdv --no-config --theme catppuccin --cols 64 --callout-style pretty example.md

╭─ Note ────────────────────────╮
│ Читайте Markdown в терминале. │
╰───────────────────────────────╯

╭─ Tip ─────────────────────╮
│ Выберите тему для работы. │
╰───────────────────────────╯

> [!NOTE]
> Читайте Markdown в терминале.

> [!TIP]
> Выберите тему для работы.

mdv --no-config --theme catppuccin --cols 64 --callout-style pretty example.md

╭─ Note ────────────────────────╮
│ Читайте Markdown в терминале. │
╰───────────────────────────────╯

╭─ Tip ─────────────────────╮
│ Выберите тему для работы. │
╰───────────────────────────╯

> [!NOTE]
> Читайте Markdown в терминале.

> [!TIP]
> Выберите тему для работы.

mdv --no-config --theme catppuccin --cols 64 --callout-style pretty example.md

╭─ Note ────────────────────────╮
│ Читайте Markdown в терминале. │
╰───────────────────────────────╯

╭─ Tip ─────────────────────╮
│ Выберите тему для работы. │
╰───────────────────────────╯

> [!NOTE]
> Читайте Markdown в терминале.

> [!TIP]
> Выберите тему для работы.

mdv --no-config --theme catppuccin --cols 64 --callout-style 'pretty:show-icons' example.md

╭─  Подробности ──────────────╮
│ Содержимое остаётся видимым. │
╰──────────────────────────────╯

> [!NOTE]- Подробности
> Содержимое остаётся видимым.

--custom-callout

--custom-callout <name:icon=...,color=...;...>

Переопределение или добавление подписей callout.

• icon и color можно указывать по отдельности; формат цвета как в --custom-theme.

• Для корректного отображения иконок, включённых через show-icons и fold-icons, нужны шрифты Nerd Fonts в терминале. Для show-simple-icons они не требуются.

mdv --no-config --theme catppuccin --cols 64 example.md

╭─ Note ────────────────────────╮
│ Читайте Markdown в терминале. │
╰───────────────────────────────╯

╭─ Tip ─────────────────────╮
│ Выберите тему для работы. │
╰───────────────────────────╯

> [!NOTE]
> Читайте Markdown в терминале.

> [!TIP]
> Выберите тему для работы.

--checkbox-style

-x, --checkbox-style <square|circle>

Рендерит чекбоксы task-list как иконки Nerd Font вместо стандартных [ ] / [x].

• Требует шрифт Nerd Font в терминале.

mdv --no-config --theme catppuccin --cols 64 example.md

[ ] Прочитать руководство
[✓] Установить mdv

- [ ] Прочитать руководство
- [x] Установить mdv

--custom-checkbox

--custom-checkbox <PAIRS>

Переопределяет встроенные иконки чекбоксов или добавляет новые состояния (только с --checkbox-style).

• Каждая разделённая точкой с запятой пара задаётся как <char>:<icon>[:<color>] или <char>:<color>.

• Форма только с цветом сохраняет существующую иконку, а для нового состояния использует стандартную иконку неотмеченного чекбокса.

• Цвета принимают именованные, hex, rgb и ansi(N).

• Переопределение: --custom-checkbox ' :!' заменить иконку неотмеченного

• Добавление: --custom-checkbox '*:*' добавить состояние [*]

• Цвет: --custom-checkbox ' :!:yellow' или #ff0000, 128,1,1, ansi(200)

• Только цвет: --custom-checkbox '?:red' сохраняет значок Nerd Font для состояния ? и задаёт красный цвет.

• Новое состояние, только цвет: --custom-checkbox '*:yellow' использует стандартный значок неотмеченного чекбокса и жёлтый цвет.

mdv --no-config --theme catppuccin --cols 64 --checkbox-style square example.md

󰄱 Прочитать руководство
󰄲 Установить mdv
[*] Проверить настройки
󰞋 Задать вопрос

- [ ] Прочитать руководство
- [x] Установить mdv
- [*] Проверить настройки
- [?] Задать вопрос

--list-style

-L, --list-style <стиль>

Заменяет стандартные маркеры - неупорядоченных списков на набор иконок по уровням.

• Значение обязательно и задаётся в формате type:<nerd-font|unicode>;size:<large|small>, например --list-style 'type:unicode;size:small'.

• size меняет только маркеры Nerd Font. Для Unicode принимаются оба значения, но набор остаётся одинаковым; его отображение зависит от шрифта. Проверено на семействах Nerd Font, особенно JetBrainsMono Nerd Font.

mdv --no-config --theme catppuccin --cols 64 example.md

- Документы
  - Руководства
    - Установка
      - Linux
- Примеры

- Документы
  - Руководства
    - Установка
      - Linux
- Примеры

--definition-marker-style

-D, --definition-marker-style <unicode|nerd-font>

Выводит описания definition list со встроенным Unicode- или Nerd Font-маркером.

mdv --no-config --theme catppuccin --cols 64 example.md

Тема
  Цвета документа.

Пресет
  Группа готовых настроек.

Тема
: Цвета документа.

Пресет
: Группа готовых настроек.

--uniform-list-marker

--uniform-list-marker <level:1-4|icon:глиф>

Использует один маркер на всех уровнях вложенности (только с --list-style).

• level:2 берёт второй маркер выбранного набора
• icon:* задаёт собственный глиф.

mdv --no-config --theme catppuccin --cols 64 --list-style 'type:unicode;size:small' example.md

⦁ Документы
  ▪ Руководства
    ⚬ Установка
      ▫ Linux
⦁ Примеры

- Документы
  - Руководства
    - Установка
      - Linux
- Примеры

--custom-list

--custom-list <уровень>:<иконка>[:<цвет>];...

Переопределяет иконку и/или цвет маркера для конкретных уровней вложенности (только с --list-style).

• Уровень - 1-based; иконка - глиф маркера.

• Цвета принимают именованные (red), hex (#ff0000), rgb (255,0,0) и ansi(N).

• Иконка + цвет: --custom-list '1:*:yellow' маркер * жёлтого цвета

• Только иконка: --custom-list '1:>' маркер > в цвете темы

• Только цвет: --custom-list '1:red' встроенная иконка, красный цвет

mdv --no-config --theme catppuccin --cols 64 --list-style 'type:unicode;size:small' example.md

⦁ Документы
  ▪ Руководства
    ⚬ Установка
      ▫ Linux
⦁ Примеры

- Документы
  - Руководства
    - Установка
      - Linux
- Примеры

--cols

-c, --cols <N>

Фиксированная ширина вывода.

• Без него используется определённая ширина терминала, если она не меньше 20 столбцов, затем cols из конфигурации, затем 80 столбцов.

mdv --no-config --theme catppuccin --cols 40 --wrap word example.md

Просмотрщик Markdown сохраняет 
читаемость длинного абзаца при изменении
ширины терминала. Каждый параметр 
управляет расположением слов без 
изменения самого документа.

Просмотрщик Markdown сохраняет читаемость длинного абзаца при изменении ширины терминала. Каждый параметр управляет расположением слов без изменения самого документа.

--margin

-m, --margin <right:N;left:N>

Задаёт левый и/или правый отступ.

• Неуказанная сторона равна 0.

mdv --no-config --theme catppuccin --cols 64 example.md

Просмотрщик Markdown сохраняет читаемость длинного абзаца при из
менении ширины терминала. Каждый параметр управляет расположение
м слов без изменения самого документа.

Просмотрщик Markdown сохраняет читаемость длинного абзаца при изменении ширины терминала. Каждый параметр управляет расположением слов без изменения самого документа.

--tab-length

--tab-length <N>

Замена символов табуляции на N пробелов (по умолчанию 4).

mdv --no-config --theme catppuccin --cols 64 --tab-length 2 example.md

  name  status
  mdv  ready

```text
name	status
mdv	ready
```

--wrap

-w, --wrap <char|word|none>

Стратегия переноса текста, кода, callout-блоков и содержимого ячеек таблиц (по умолчанию char).

mdv --no-config --theme catppuccin --cols 40 --wrap char example.md

Просмотрщик Markdown сохраняет читаемост
ь длинного абзаца при изменении ширины т
ерминала. Каждый параметр управляет расп
оложением слов без изменения самого доку
мента.

Просмотрщик Markdown сохраняет читаемость длинного абзаца при изменении ширины терминала. Каждый параметр управляет расположением слов без изменения самого документа.

--reflow

Склеивает внутриабзацные мягкие переносы строк (soft breaks) и заново заполняет каждую строку до ширины переноса, так что жёстко разбитый исходник перетекает под узкие экраны.

• Требует включённого переноса; жёсткие переносы сохраняются.

mdv --no-config --theme catppuccin --cols 64 --wrap word example.md

Этот абзац перенесён
в исходном файле.
Просмотрщик может объединить
его мягкие переводы строк.

Этот абзац перенесён
в исходном файле.
Просмотрщик может объединить
его мягкие переводы строк.

--table-wrap

-W, --table-wrap <fit|wrap|none>

Геометрия таблиц: подогнать ячейки, разделить колонки на блоки или разрешить переполнение (по умолчанию fit).

• Точки переноса в ячейках определяет --wrap.

mdv --no-config --theme catppuccin --cols 40 --table-wrap fit example.md

 Name    │ Description         │ Status 
─────────┼─────────────────────┼────────
 reader  │ Comfortable long-fo │ ready  
         │ rm reading with wor │        
         │ d wrapping          │        
 compact │ Dense output for a  │ ready  
         │ narrow terminal wor │        
         │ kspace              │

| Name | Description | Status |
| --- | --- | --- |
| reader | Comfortable long-form reading with word wrapping | ready |
| compact | Dense output for a narrow terminal workspace | ready |

--table-borders

-B, --table-borders

Возвращает полные скруглённые рамки у таблиц.

mdv --no-config --theme catppuccin --cols 64 example.md

 Name    │ Wrap 
─────────┼──────
 reader  │ word 
 compact │ char

| Name | Wrap |
| --- | --- |
| reader | word |
| compact | char |

--table-smart-indent

-S, --table-smart-indent

Автоматический подбор отступа таблицы в зависимости от доступной ширины.

mdv --no-config --theme catppuccin --cols 40 example.md

     Settings
      
 Name    │ Description         │ Status 
─────────┼─────────────────────┼────────
 reader  │ Comfortable long-fo │ ready  
         │ rm reading with wor │        
         │ d wrapping          │        
 compact │ Dense output for a  │ ready  
         │ narrow terminal wor │        
         │ kspace              │

###### Settings

| Name | Description | Status |
| --- | --- | --- |
| reader | Comfortable long-form reading with word wrapping | ready |
| compact | Dense output for a narrow terminal workspace | ready |

--heading-layout

-H, --heading-layout <level|center|flat|none>

Схема выравнивания заголовков (по умолчанию level).

mdv --no-config --theme catppuccin --cols 64 --heading-layout level example.md

Руководство
 
 Введение.

 Установка
  
  Установите программу.

  Использование
   
   Откройте документ.

# Руководство

Введение.

## Установка

Установите программу.

### Использование

Откройте документ.

--show-heading-markers

Добавляет перед заголовками markdown-маркеры, соответствующие их уровню.

mdv --no-config --theme catppuccin --cols 64 example.md

Руководство
 
 Введение.

 Установка
  
  Установите программу.

  Использование
   
   Откройте документ.

# Руководство

Введение.

## Установка

Установите программу.

### Использование

Откройте документ.

--smart-indent

-I, --smart-indent

Сглаживание скачков отступов между уровнями заголовков в режиме level.

mdv --no-config --theme catppuccin --cols 64 example.md

Руководство
 
 Введение.

   Подробности
    
    Пропущен уровень заголовка.

# Руководство

Введение.

#### Подробности

Пропущен уровень заголовка.

--code-wrap-indent

--code-wrap-indent <none|base|double>

Управляет «висячим» отступом при переносе строк внутри блоков кода (по умолчанию double).

mdv --no-config --theme catppuccin --cols 44 --code-wrap-indent none example.md

  fn main() {
      let message = "A long line of code tha
  t wraps to the available terminal width";
      println!("{message}");
  }

```rust
fn main() {
    let message = "A long line of code that wraps to the available terminal width";
    println!("{message}");
}
```

--block-spacing

--block-spacing <спецификация>

Переопределяет количество пустых строк сверху и снизу для отдельных блоков.

• Неуказанные стороны сохраняют стандартные значения, а отступы соседних блоков схлопываются до большего значения.

mdv --no-config --theme catppuccin --cols 64 example.md

 Первый раздел
  
  Первый абзац.
  
  Второй абзац.

 Следующий раздел
  
  Продолжайте чтение.

## Первый раздел

Первый абзац.

Второй абзац.

## Следующий раздел

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

--horizontal-rule-style

--horizontal-rule-style <pretty|simple>

Рисует разделители Markdown и HTML <hr> с декоративными символами по краям или сплошной линией.

mdv --no-config --theme catppuccin --cols 64 --horizontal-rule-style pretty example.md

До разделителя.

◈──────────────────────────────────────────────────────────────◈

После разделителя.

До разделителя.

---

После разделителя.

--show-empty-elements

Отображение обычно скрытых пустых заголовков, списков, цитат, блоков кода и таблиц.

mdv --no-config --theme catppuccin --cols 64 --code-block-style 'pretty:show-name' example.md

Перед пустым блоком кода.

После блока.

Перед пустым блоком кода.

```rust
```

После блока.

--no-code-guessing

Отключение эвристики определения языка; неизвестные блоки остаются текстом.

mdv --no-config --theme catppuccin --cols 64 example.md

  #!/usr/bin/env python3
  def greet(name):
      print(f"Hello, {name}!")
  greet("mdv")

```
#!/usr/bin/env python3
def greet(name):
    print(f"Hello, {name}!")
greet("mdv")
```

--link-style

-u, --link-style <clickable|fclickable|inline|inlinetable|endtable|hide>

Способ отображения ссылок (по умолчанию clickable).

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

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

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

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

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

--link-overflow

-l, --link-overflow <wrap|cut|tablecut|none>

Определяет, переносить, обрезать или разрешать переполнение длинных ссылок (по умолчанию wrap).

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

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)

[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

--footnote-style <endnotes|attached>

Размещение сносок в конце документа или сразу после блока со ссылкой, включая абзацы, таблицы и элементы списков.

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

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

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

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

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

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

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

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

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

--missing-footnote-style

--missing-footnote-style <show|hide>

Поведение для отсутствующих, некорректных или пустых определений сносок.

• show выводит сообщение-заглушку в блоке сносок hide полностью скрывает такие записи.

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

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

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

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

mdv help

Открывает полный вывод mdv --help в выбранном pager.

• Если задан MDV_PAGER, используется он, иначе встроенный pager; при перенаправлении ввода или вывода та же справка печатается напрямую.

-h

Краткая сводка параметров.

--help

Полная справка с описаниями значений, форматами и примерами.

--version

-V, --version

Отображение текущей версии.