.. _html-output:

############
HTML Support
############

The `CommonHTML` (CHTML) output processor renders your mathematics
using HTML with CSS styling.  It produces high-quality output in all
modern browsers, with results that are consistent across browsers and
operating systems.  This is MathJax's primary output mode since
MathJax version 2.6. Its major advantage is its quality, consistency,
and the fact that its output is independent of the browser, operating
system, and user environment.  This means you can pre-process
mathematics on a server, without needing to know the browser, what
fonts are available, and so on.  (In version 2, both the ``HTML-CSS``
and ``NativeMML`` processors produced different output for different
browsers and user environments.)

The CommonHTML output uses web-based fonts so that users don't have to
have math fonts installed on their computers. Version 3 only supports
MathJax's limited TeX fonts, but version 4 introduces almost a dozen
additional font options.  See the :ref:`font-support` section for more
information on what fonts are available and how to select them.

The CHTML output component (:ref:`chtml-component`) is included in all
the :ref:`combined-components` that include `chtml` in their names.
You can also load it explicitly by including ``output/chtml`` in the
:data:`load` array of the :data:`loader` block of your MathJax
configuration.

.. code-block::

   MathJax = {
     loader: {
       load: ['output/chtml']
     }
   };

See :ref:`chtml-options` for information about the options that
control the CommonHTML output processor.

|-----|