Markdown Navigator (Навигация по Markdown)

Markdown Navigator — это дополнение для NVDA, предназначенное для улучшения работы с Markdown-контентом. Оно позволяет использовать навигацию по одной клавише, подобно режиму обзора NVDA, в редактируемых текстовых полях (таких как Блокнот, VS Code, веб-редакторы и т.д.).

С его помощью можно быстро переходить к заголовкам, спискам, таблицам, блокам кода и различным элементам форматирования, не используя часто клавиши со стрелками.

Ключевые особенности

Эффективная навигация: Используются быстрые алгоритмы, обеспечивающие мгновенные переходы даже в больших документах, содержащих десятки тысяч строк.
Структурированный просмотр: Поддерживается навигация по заголовкам, спискам, таблицам, цитатам, блокам кода и другим элементам.
Строчные элементы: Реализована навигация по полужирному тексту, курсиву, ссылкам, изображениям и строчному коду.
Навигация по ячейкам таблиц: Поддерживаются сочетания клавиш, аналогичные стандартным в NVDA, для перемещения между ячейками в Markdown-таблицах.

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

Включение и выключение режима обзора

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

Сочетание клавиш: NVDA + Shift + Пробел (Пробел)
Результат: Включает или выключает функциональность дополнения. NVDA объявит «Режим обзора Markdown вкл» или «Режим обзора Markdown выкл». Эта функция также подчиняется настройке «Звуковые сигналы при смене режимов обзора и фокуса» в параметрах режима обзора NVDA.

Список клавиш (когда режим обзора включен)

Когда режим включен, вы можете использовать следующие одиночные клавиши.
* Нажмите Буквенную клавишу, чтобы перейти к следующему элементу.
* Нажмите Shift + Буквенная клавиша, чтобы перейти к предыдущему элементу.

Клавиша	Тип элемента	Описание
H	Заголовок	Заголовок любого уровня (`#` to `######`)
1-6	Заголовок 1-6	Заголовок определенного уровня
T	Таблица	Начало таблицы
L	Список	Начало блока списка
I	Элемент списка	Конкретный элемент списка (`-`, `*`, `1.`)
Q	Цитата	Блок цитаты (`>`)
C	Код	Блок кода (```) или строчный код (`)
S	Разделитель	Горизонтальная линия (`---`, `***`)
X	Флажок	Элемент списка задач (`- [ ]`, `- [x]`)
K	Ссылка	Markdown-ссылка `[text](url)`
G	Графика	Изображение `![alt](url)`
B	Полужирный	Полужирный текст (`**` или `__`)
E	Курсив	Курсив/Выделение (`*` или `_`)
D	Зачеркнутый	Зачеркнутый текст (`~~`)
F	Сноска	Ссылка на сноску `[^1]`
,	Конец блока	Перейти в конец текущего блочного элемента
Shift+,	Начало блока	Перейти в начало текущего блочного элемента
M	Математика	LaTeX-выражение ( $...$ или `$$...$$`)

Навигация по ячейкам таблицы

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

Ctrl + Alt + Стрелка влево: Предыдущая ячейка
Ctrl + Alt + Стрелка вправо: Следующая ячейка
Ctrl + Alt + Стрелка вверх: Ячейка выше
Ctrl + Alt + Стрелка вниз: Ячейка ниже

Примечания

Данное дополнение специально разработано для сценариев редактирования Markdown. Если вы читаете HTML-страницу, отображенную в браузере, используйте встроенный режим обзора NVDA.
Если при нажатии вышеуказанных клавиш вводятся символы, а не происходит навигация, проверьте, включен ли режим обзора с помощью комбинации NVDA + Shift + Пробел.
В VS Code, из-за того, что редактор отображает контент по мере необходимости (виртуализация), режим обзора этого дополнения может работать некорректно с контентом, который в данный момент не виден/не отрисован.