# LaTeX в MathML

Преобразуйте формулу LaTeX в разметку MathML с помощью KaTeX 0.19.1. Результат — один элемент math с презентационным MathML и исходным кодом LaTeX в аннотации; доступен режим отображения или встроенный режим. Разметку можно сразу вставить в документы HTML, EPUB или XML. MathML отображается средствами браузеров Chrome, Edge, Firefox и Safari, а программы чтения с экрана могут озвучивать формулы, делая их доступными без JavaScript.

## Часто задаваемые вопросы

### Как выглядит результат?

Вы получите один элемент math в пространстве имен MathML с оберткой semantics. Внутри находится презентационный MathML, построенный из таких элементов, как mi, mn, mo, mfrac, msup и mtable, а за ним — элемент annotation с кодировкой application/x-tex, содержащий исходный код LaTeX. В режиме отображения к элементу math добавляется display="block".

### Где можно использовать MathML?

Вставьте его прямо на страницу HTML5, в книгу EPUB 3, XHTML или в формат XML, например JATS или DocBook. Многие редакторы формул и офисные пакеты также умеют импортировать MathML, поэтому он удобен для обмена данными между инструментами, которые не читают LaTeX.

### Отображают ли браузеры MathML?

Да. Chrome и Edge начиная с версии 109, Firefox и Safari отображают MathML самостоятельно, без скриптов и таблиц стилей. Браузеры используют собственные математические шрифты, поэтому результат немного отличается от HTML в KaTeX, но структура и правила расстановки интервалов одинаковы.

### Чем режим отображения отличается от встроенного режима?

В режиме отображения формула получает атрибут display="block" и набирается как отдельное уравнение с полноразмерными дробями и пределами над и под крупными операторами. Во встроенном режиме атрибут отсутствует, а формула набирается компактным шрифтом, подходящим для обычного текста.

### Сохраняется ли исходный код LaTeX?

Да. KaTeX хранит исходный код в элементе annotation внутри обертки semantics. Браузеры его не отображают, но инструменты копирования и другие конвертеры могут использовать его, чтобы восстановить исходный код LaTeX без изменений. Удалите элемент annotation, если не хотите хранить исходный код в документе.

### Какие команды LaTeX поддерживаются?

Поддерживается всё, что поддерживает KaTeX 0.19.1, включая дроби, корни, матрицы, окружения, например aligned, cases и array, акценты, стрелки, команды шрифтов вроде \mathbb и \mathcal, а также \text и \tag. Работают и макросы, заданные с помощью \def или \newcommand внутри формулы. Полные документы, \usepackage и команды mhchem \ce недоступны.

### Что произойдет, если в формуле есть ошибка?

MathML не возвращается. Инструмент сообщает о проблеме и указывает символ, в котором она возникает, считая с 1. Например, это может быть неизвестная команда, несбалансированные фигурные скобки, двойной верхний индекс или команда без аргумента.

### Есть ли ограничения?

Длина формулы может составлять до 10,000 символов, макросы могут раскрываться не более 1,000 раз, а размеры, указанные в таких командах, как \rule и \kern, ограничены значением 100em. Команды, связывающие или загружающие внешний контент, например \href, \url и \includegraphics, отключены и отображаются как неподдерживаемый текст.

### Подходит ли MathML для людей, использующих вспомогательные технологии?

Да. Программы чтения с экрана, такие как VoiceOver, NVDA и JAWS, умеют читать MathML и позволяют пользователям разбирать формулу по частям — изображение этого не обеспечивает. Хранить математические формулы в MathML, а не в виде изображений, — один из самых простых способов сделать технический контент доступным.

### Чем это отличается от обычного вывода KaTeX?

На веб-странице KaTeX обычно выводит стилизованный HTML для отображения, а также скрытый MathML для программ чтения с экрана. Этот инструмент возвращает только часть MathML — именно в том виде, как её создаёт KaTeX, без обёртывающего span, таблицы стилей и шрифтов, поэтому результат работает везде, где понимается MathML.

Ваша реклама здесь?

[Напишите нам по электронной почте](mailto:hi@dennn.is?subject=%D0%A0%D0%B5%D0%BA%D0%BB%D0%B0%D0%BC%D0%B0%20%D0%BD%D0%B0%20OneClick%20Pro)

[Реклама Набор плагинов для работы агентов с WordPress.](https://sleekwp.com/?ref=oneclickpro)