diff --git a/config.org b/config.org
index b1b72aa..3cb6f10 100644
--- a/config.org
+++ b/config.org
@@ -825,6 +825,28 @@
      (smart-tabs-insinuate 'glsl)
    #+end_src
 
+** Mermaid
+   Mermaid is a very nice diagramming language. First of all we need
+   syntax highlighting etc. This is provided by =mermaid-mode=:
+
+   #+begin_src emacs-lisp
+     (use-package mermaid-mode)
+   #+end_src
+
+   Also install =ob-mermaid= to add mermaid support to org-babel:
+
+   #+begin_src emacs-lisp
+     (use-package ob-mermaid)
+   #+end_src
+
+   And finally allow execution of mermaid source blocks (used to view the
+   diagrams):
+
+   #+begin_src emacs-lisp
+     (add-to-list 'org-babel-load-languages
+                  '(mermaid . t))
+   #+end_src
+
 * Tool Integrations
 ** Git
    =magit= is truly a wonderful creation! Add keybinding for