FxEditor
User guideQuickstartDeploymentAPIDesignFxTeX
APIExamplesRight-click menuAccessibilityFxTeX Server
OverviewAPIAccess and keysSelf-hostingPlugins
OverviewCKEditor 5TinyMCE 6 and 7BloggerAngularFroalaTiptapWordPressMoodleGoogle Docs and SlidesCanvas, Blackboard and LTITiddlyWikiWriting your own
Licensing
How licensing worksPlugins
If your site already has a rich-text editor, a CMS or a learning platform, you do not need to build an equation editor into it yourself. Each plugin below adds an fx button that opens fxEditor and puts the finished equation into the document.
Available plugins
| Platform | Versions | Inserts | Status |
|---|---|---|---|
| CKEditor 5 | v42 and later | MathML or SVG image | Released |
| CKEditor 4 | 4.x | MathML or SVG image | Legacy |
| TinyMCE | 6 and 7 | MathML or SVG image | Released |
| TinyMCE 4 | 4.x | MathML or SVG image | Legacy |
| Froala | 3 and 4 | MathML or SVG image | Preview |
| Tiptap / ProseMirror | Tiptap 2 | MathML or SVG image | Preview |
| WordPress | 5.0 to 7.1, Classic Editor | MathML or SVG image | Preview |
| Moodle | 4.1 and later | Image, LaTeX or MathML | Preview |
| Google Docs and Slides | — | Image | Preview |
| Canvas, Blackboard, Brightspace, Schoology | LTI 1.3 | Image | Preview |
| TiddlyWiki | 5.4 and later | MathML or SVG image | Preview |
| Blogger | — | Renders LaTeX in posts | Released |
| Angular | — | Via the TinyMCE plugin | Released |
Released plugins are published and supported. Preview plugins are new: they work, but have not yet been through a full release on their platform, and each page says what has been tested. Ask us for a copy — and tell us what you find. Legacy plugins are for older editor versions, kept for sites that still run them.
Your platform is not listed? Every plugin is built on the same public API, and Writing your own shows how. Or ask us.
What every plugin shares
A licence key
The equation editor is activated with your fxEditor licence key, the same
one you would pass to EqEditor.init()
directly. Each plugin has an option for it — the names differ only to follow each
platform's own conventions:
| Plugin | Licence option |
|---|---|
| CKEditor 5 | eqnEditor: { licence: '…' } |
| CKEditor 4 | config.eqneditor_licence |
| TinyMCE 4, 6 and 7 | eqneditor_licence |
| Froala | eqneditorLicence |
| Tiptap | EqnEditor.configure({ licence: '…' }) |
| WordPress | window.eqneditorLicence |
| Moodle | Licence key, in the plugin's site settings |
| Google Docs and Slides | Script property EQNEDITOR_LICENCE |
| LTI 1.3 | Environment variable EQNEDITOR_LICENCE |
| TiddlyWiki | Tiddler $:/config/codecogs/eqneditor/Licence |
Your key is in the licence manager. Without one, equations show the reason they cannot render in place of the maths.
Where the editor comes from
Plugins are small. The equation editor itself is loaded from
fxeditor.codecogs.com when it is first needed, so you always have the current
version without rebuilding. Each plugin has a server option to load it from somewhere
else, and a render URL option naming the
fxTeX Server that draws equations
inserted as images — change it to use a
self-hosted one.
MathML or an image
Most plugins let the author choose, in the equation dialog, how each equation is inserted:
MathML, the default: the mathematics itself, with its spoken form attached for screen readers. It needs nothing from us when the page is read, and scales and reflows with the text around it.
An SVG image, drawn by fxTeX Server, with the LaTeX as its
alt text. It shows anywhere a picture can, but every view of the page is a request
to the rendering service.
Either way the LaTeX travels with the equation, so it can be reopened and edited later.
A stylesheet for published MathML
The plugins style MathML inside the editor for you. The page that finally shows your content needs one line to do the same:
<link rel="stylesheet" href="https://fxtex.codecogs.com/fxtex.css">
Or add fxTeX to that page, which carries the stylesheet itself and gives every equation the right-click menu.
More
User guide — what your authors see inside the equation dialog.
Writing your own — building a plugin for a platform not listed here.
How licensing works — which products need a licence, and when.
CodeCogs®