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.