TeX4ht: LaTeX and TeX for Hypertext

The TeX4ht home page is at https://tug.org/tex4ht. Please see that page for current development information, including a bug tracker and mailing lists.

TeX4ht is still actively maintained, and many individual files have been updated; new versions are committed to the TeX4ht and TeX Live repositories.

Unfortunately, no full release of TeX4ht has been made since Eitan Gurari, the original author, passed away unexpectedly in June 2009. When a release is finally made (there is no ETA at present), it will be available on CTAN.

TeX4ht is a highly configurable TeX-based authoring system dedicated mainly to produce hypertext. It interacts with TeX-based applications through style files and postprocessors, leaving the processing of the source files to the native TeX compiler. Consequently, TeX4ht can handle the features of TeX-based systems in general, and of the LaTeX and AMS style files in particular.

Pre-tailored configurations are offered for different output formats, including HTML 5, (X)HTML, MathML, OpenDocument, and DocBook.

 Table of Contents  Using the System  Calling Commands  Configurations  Installation  Bug Reports  Resources  License  Acknowledgments  Index

troubleshooting | Q/A | common problems for MathML

bug fixes - TeX4ht

Using the System

Typical LaTeX source files can be compiled into standard HTML and XML formats in a manner similar to the way they are compiled into print formats, namely, through variations of the command htlatex filename "options1" "option2" "options3" "options4"’. For instance,

htlatex  filename  # generate HTML 
xhlatex  filename  # generate XHTML 

For details, visit the calling commands section.


The main features of TeX4ht are described in:


TeX4h is included in TeX distributions, notably TeX Live and MikTeX. You don’t have to install it manually. The following information is outdated and it is kept here mainly for the historical reasons.

To be installed, the system needs a port made up of native utilities of TeX4ht and of non-native utilities. The easiest way to establish an up to date port is to download an installed distribution of the system, and upgrade and MS Windows require additional effort, mainly because of the need to set up non-native utilities. Alternative ports for these and other platforms can be tailored in a similar manner. The distribution assumes compilations through command lines but graphical user inferfaces may also be employed.

Philip A. Viton discusses in details issues of installing TeX4ht under MikTeX and Scientific Word/WorkPlace, but many of the topics apply also to other platforms. Steven Zeil offers improvements for the above settings.

The literate sources of TeX4ht are also available, but they are not needed for installing the system. The literate views are very far from being in a desirable state for a review by a public eye—they reflect their true nature as being privately used for developing and maintaining the available code. The views follow a basement mentality: throw in without much scrutiny any item of possible value at some point of time, and clean a corner when the need arises for working on a specific issue of the code. The leading lines in the files indicate how the files can be compiled.

troubleshooting| bug fixes

Bug Reports

The development of the TeX4ht system is to a large degree driven by users’ bug reports and requests. The bug reports can be posted on TeX4ht issue tracker. In most cases, when providing feedback, it is essential to include the following information.

Translations of source files are centered on logical structures. Formatting instructions receive only limited attention.


Languages: LaTeX/TeX, HTML, XML/XSLT, MathML, OpenDocument, DocBook, TEI, Style Sheets, Validators
for other


TeX4ht is provided under the LaTeX Project Public License (LPPL).


Eitan gratefully acknowledges the suggestions, contributions, and bug reports offered by many people. In particular, thanks go to Carmen Fierro, Piotr Grabowski, Gertjan Klein, Sebastian Rahtz, and Philip Viton for extensive feedback and help at early stages of this project.

Eitan’s work was partially sponsored by NSF grant IIS-0312487.

Subsequent work has been a community effort involving many people. Contributors, bug reporters, and all, are listed in the ChangeLog file in the sources.

Generated August 24, 2020 - tex4ht home page