Emacs major mode for working with mermaid graphs
- Install from Melpa or load the
mermaid-mode.el
file - Install
mmdc
binary from the mermaid-cli project if you plan to compile graphs in Emacs
Currently supporting flow charts and sequence diagrams with syntax coloring and indentation.
C-c C-c - compile current file to an image
C-c C-f - compile given file to an image
C-c C-b - compile current buffer to an image
C-c C-r - compile current region to an image
C-c C-o - open in the live editor
C-c C-d - open the official doc
Note: All compile commands will open the output in a buffer to view the resulting image.
You can specify the location of mmdc
with the variable mermaid-mmdc-location
, the default assumes you have the binary in your PATH
(and for that you probably want/need to install mermaid-cli
).
By default mmdc
will compile to png format. You can change that by setting the variable mermaid-output-format
.
By default mermaid-tmp-dir
points to \tmp\
. Feel free to set it to a more appropriate location that works for you (e.g. on windows).
To customize the key bindings but this into your init.el
...
(setq mermaid-mode-map
(let ((map mermaid-mode-map))
(define-key map (kbd "C-c C-c") nil)
(define-key map (kbd "C-c C-f") nil)
(define-key map (kbd "C-c C-b") nil)
(define-key map (kbd "C-c C-r") nil)
(define-key map (kbd "C-c C-o") nil)
(define-key map (kbd "C-c C-d") nil)
(define-key map (kbd "C-c C-d c") 'mermaid-compile)
(define-key map (kbd "C-c C-d c") 'mermaid-compile)
(define-key map (kbd "C-c C-d f") 'mermaid-compile-file)
(define-key map (kbd "C-c C-d b") 'mermaid-compile-buffer)
(define-key map (kbd "C-c C-d r") 'mermaid-compile-region)
(define-key map (kbd "C-c C-d o") 'mermaid-open-browser)
(define-key map (kbd "C-c C-d d") 'mermaid-open-doc)
map))
Feel free to open an issue!