d4324a724b
* Add warning re:defer to mhchem documentation. * Edit description of defer behavior. * Add nuance to the explanation regarding `defer`.
mhchem extension
This extension adds to KaTeX the \ce and \pu functions from the mhchem package.
Usage
This extension isn't part of core KaTeX, so the script should be separately included. Write the following line into the HTML page's <head>. Place it after the line that calls katex.js.
<script defer src="https://cdn.jsdelivr.net/npm/katex@0.12.0/dist/contrib/mhchem.min.js" integrity="sha384-5gCAXJ0ZgozlShOzzT0OWArn7yCPGWVIvgo+BAd8NUKbCmulrJiQuCVR9cHlPHeG" crossorigin="anonymous"></script>
If you remove the defer attribute from this tag, then you must also remove the defer attribute from the <script src="https://../katex.min.js"> tag.
Syntax
See the mhchem Manual for a full explanation of the input syntax, with working examples. The manual also includes a demonstration box.
Note that old versions of mhchem.sty used \cf for chemical formula and \ce for chemical equations, but \cf has been deprecated in place of \ce. This extension supports only \ce. You can define a macro mapping \cf to \ce if needed.
Browser Support
This extension has been tested on Chrome, Firefox, Opera, and Edge.