diff --git a/contrib/mkdocs/README.md b/contrib/mkdocs/README.md
index 7f38b7a61e..3794b00497 100644
--- a/contrib/mkdocs/README.md
+++ b/contrib/mkdocs/README.md
@@ -68,3 +68,30 @@ mkdocs -v gh-deploy --config-file /path/to/mkdocs/mkdocs.yml --remote-branch mas
 
 Browse new web pages at
 https://nwchemgit.github.io/
+
+## tools for rendering latex math equations
+
+* python-markdown-math
+https://github.com/mitya57/python-markdown-math
+https://pypi.org/project/python-markdown-math/
+```
+python3 -m pip install python-markdown-math
+```
+https://github.com/mkdocs/mkdocs/issues/253
+* arithmatex from pymdown-extensions
+```
+python3 -m pip install pymdown-extensions
+```
+https://facelessuser.github.io/pymdown-extensions  
+
+Caveat: gets confused by the existing latex2svg embedded images
+
+* katex
+https://pypi.org/project/markdown-katex/
+https://gitlab.com/mbarkhau/markdown-katex
+```
+python3 -m pip install markdown-katex
+```
+Not tried yet
+
+* more in https://github.com/Python-Markdown/markdown/wiki/Third-Party-Extensions
\ No newline at end of file