diff --git a/docs/images/Katex_mhchem.png b/docs/images/Katex_mhchem.png
new file mode 100644
index 0000000000..54738faa8c
Binary files /dev/null and b/docs/images/Katex_mhchem.png differ
diff --git a/joplin.code-workspace b/joplin.code-workspace
index e66469e31c..498e557f85 100644
--- a/joplin.code-workspace
+++ b/joplin.code-workspace
@@ -13,6 +13,11 @@
 			"**/_mydocs/EnexSamples/*.enex": true,
 			"**/*.base64": true,
 			"**/*.bundle.js": true,
+			"**/*.ttf": true,
+			"**/*.eot": true,
+			"**/*.woff": true,
+			"**/*.woff2": true,
+			"**/*.ico": true,
 			"**/*.icns": true,
 			"**/*.jar": true,
 			"**/*.map": true,
@@ -57,6 +62,7 @@
 			"ElectronClient/build/": true,
 			"ElectronClient/dist/": true,
 			"node_modules/": true,
+			"docs/images/flags": true,
 			"ReactNativeClient/android/.gradle/": true,
 			"ReactNativeClient/android/.idea/": true,
 			"ReactNativeClient/android/app/build/": true,
diff --git a/readme/markdown.md b/readme/markdown.md
index fc32e61e71..4d433dcd48 100644
--- a/readme/markdown.md
+++ b/readme/markdown.md
@@ -88,7 +88,13 @@ For example:
 
 Here is an example with the Markdown and rendered result side by side:
 
-<img src="https://joplinapp.org/images/Katex.png" height="400px">
+<img src="https://joplinapp.org/images/Katex.png" height="345px">
+
+### Chemical equations
+
+Joplin supports chemical equations via the mhchem plugin for KaTeX. This plugin is automatically enabled if you enable math notation. See the [mhchem documentation](https://mhchem.github.io/MathJax-mhchem/) for the syntax.
+
+<img src="https://joplinapp.org/images/Katex_mhchem.png" height="196px">
 
 ### Checkboxes