Table of Contents

Configuration layers

Table of ContentsClose


Don't edit it directly. See " tags" section of for instructions.

2 Chats

2.1 Erc


Layer for ERC IRC chat.


  • Highlight nicks (using erc-hl-nicks)
  • Image inline support (using erc-image)
  • Logging to ~/.emacs.d/.cache/erc-logs and ViewLogMode for viewing logs (using erc-view-log)
  • YouTube videos Thumbnails inline (using erc-yt)
  • Social Graph for ERC messages (using erc-social-graph)
  • Optional SASL authentication via the variable erc-enable-sasl-auth (using erc-sasl)
  • D-BUS notifications via the variable erc-enable-notifications
  • Completion of Emojis using company-emoji (still needs a way of showing, either using the emoji layer or having a proper font) :clap:

2.2 Jabber


This layer adds support for the Jabber (XMPP) client for Emacs


  • Use Jabber without having to leave Spacemacs

2.3 Rcirc


This layer provide support for rcirc with optional support for authinfo and ZNC.


  • Store channel logs into ~/.emacs.d/.cache/rcirc-logs/<channel>
  • Support for credentials stored in ~/.authinfo.gpg (need to have gnutls)
  • Support ZNC support (with optional ~/.authinfo.gpg)
  • Colored nicknames
  • Real-time change when people use s/foo/bar/ in chat
  • Completion of Emojis using company-emoji (still needs a way of showing, either using the emoji layer or having a proper font) :clap:

2.4 Slack


This layer provides an interface to the Slack chat service via the emacs-slack package. Where possible, this layer aims to reuse key bindings from the IRC packages in Spacemacs.


3 Checkers

3.1 Spell checking


This layer provides spell checking capabilities to Spacemacs.


  • Buffer-wide spell checking via external command (ispell, hunspell, aspell) run through Flyspell.
  • Spell as you type
  • Optional correction popups, controlled by enable-flyspell-auto-completion variable.
  • Auto dictionary mode for some languages.

3.2 Syntax checking


This layer adds on the fly syntax checking to all supported language layers.


  • Support for automatic syntax checking with Flycheck for various language layers
  • Tooltip syntax errors with popwin

4 Completion

4.1 Auto-completion


This layer adds auto-completion to all supported language layers.


4.2 Helm


This layer enables Helm everywhere in Spacemacs. The alternative to this layer is the Ivy layer which brings the same level of integration as Helm.

These completion systems are the central control towers of Spacemacs, they are used to manage buffers, projects, search results, configuration layers, toggles and more…

Mastering your choice of completion system will make you a Spacemacs power user.


  • Project wide grep like text search via helm-dir-smart-do-search
  • Project wide text replacements using helm-edit-mode
  • Buffer wide dynamic text search via helm-swoop
  • Fuzzy matching for most helm-sources
  • Detailed configuration parameters for helms appearance
  • Intuitive transient state

4.3 Ivy


This layer enables Ivy for completion. It will replace the default completion by Helm.

These completion systems are the central control towers of Spacemacs, they are used to manage buffers, projects, search results, configuration layers, toggles and more…

Mastering your choice of completion system will make you a Spacemacs power user.


  • Project wide grep like text search via search-auto
  • Project wide text replacements using counsel-imenu
  • Buffer wide dynamic text search via swiper
  • Detailed configuration parameters for ivy appearance
  • Intuitive transient state
  • Advanced buffer information with ivy-rich

4.4 Templates


This layer provides templates to Spacemacs. A template consists of text that is automatically inserted into a new file when it is opened. This is done via yatemplate, which leverages yasnippet.


  • Auto-insert snippets when creating specific new files.

5 E-mail

5.1 Gnus


This layer integrates a general purpose email/newsgroup client into Spacemacs.


  • Support for reading RSS feeds, newsgroups and mails directly within Emacs via Gnus.
  • Support for beautiful HTML mails generated from any org buffer.
  • Support for credential management via GnuPG.

5.2 Mu4e


This layer adds support for the Mu4e email client.


  • Search, read, reply, move, and delete email.
  • Search-based: no folders, only queries.
  • UI optimized for speed: quick keystrokes for common actions.
  • Very extendable and customizable.
  • Integration with Helm.
  • Maildir summary using mu4e-mailidirs-extension
  • Notifications using mu4e-alert

5.3 Notmuch


Notmuch offers a fast, global-search and tag-based email system to use within your text editor or in a terminal.

This layer integrates the Notmuch Emacs package into Spacemacs.


  • Email searching
  • Email tagging

6 Emacs

6.1 Better defaults


This layer enhances the default commands of Emacs and is primarily intended to be used with the emacs editing style as it does not change anything in the Vim key bindings.

However the emacs editing style is not required, you can still use this layer while you are using the vim editing style if you have some kind of mixed style.

The commands defined in this layer are taken from various sources like Prelude.


  • Smart line navigation: Subsequent presses of C-a toggles between the beginning of the line and the first non-whitespace character. Similarly, subsequent presses of C-e will toggle between the end of the code and the end of the comments.
  • spacemacs/backward-kill-word-or-region: A combination of kill-region and backward-kill-word, depending on whether there is an active region. If there's an active region kill that. If not kill the preceding word.
  • Fill or unfill paragraph: Pressing M-q for the first time fills current paragraph and pressing M-q for the second time unfills it. Note that some modes override this key binding so it's not available everywhere. Due to implementation details unfilling doesn't work when called twice via M-x.

6.2 Ibuffer


This layer configures Emacs IBuffer for Spacemacs.


  • Grouping of buffers by major-modes
  • Grouping of buffers by projects

6.3 Org


This layer enables org mode for Spacemacs.


6.4 Semantic


CEDET is a *C*ollection of *E*macs *D*evelopment *E*nvironment *T*ools written with the end goal of creating an advanced development environment in Emacs. CEDET includes common features such as intelligent completion, source code navigation, project management, code generation with templates. CEDET also provides a framework for working with programming languages; support for new programming languages can be added and use CEDET to provide IDE-like features. This framework is called Semantic.

Semantic is a package that provides a framework for writing parsers. Parsing is a process of analyzing source code based on programming language syntax. The packages relies on Semantic for analyzing source code and uses its results to perform smart code refactoring that based on code structure of the analyzed language, instead of plain text structure. Semantic is the core of CEDET.


  • Display function or variable definition at the bottom.
  • Display current function cursor is in at the top. See this page for demos in some programming languages.
  • Support common C/C++ refactoring with semantic-refactor. See this page for demonstration of refactoring features.
  • Support Lisp source code formatting with semantic-refactor. See this page for demonstration of Lisp formatting features.

6.5 Smex


This layer provides a more traditional alternative to helm-M-x based on ido.


  • Provides an alternative way for helm-M-x based on ido and smex

6.6 Typography


This layer provides support for typographic text editing in Spacemacs.


  • Modes to automatically insert and cycle among typographic characters
  • Typo Mode automatically inserts and cycles among typographic Unicode characters on some keys.
  • Tildify Mode automatically inserts non-breaking spaces where required (Only available on Emacs 25).

7 File trees

7.1 Neotree


This layer setups a file tree navigator buffer using Neotree (replacing the Treemacs layer).


  • intuitive evil key bindings integration
  • supports multiple themes
  • transient state by pressing on ?
  • version-control integration

7.2 Treemacs


This layer sets up a file navigation and project explorer side-window via Treemacs.


An detailed overview over Treemacs' available features is available in its readme. In a short summary Treemacs offers the following:

  • Simple and powerful navigation and ability to detail exactly how and where a file should be opened
  • Good looking png icons.
  • Display of multiple file trees organized as projects residing in a workspace.
  • Ability to show tags contained in files. Tags are provided by imenu, so nearly every filetype is supported.
  • Mouse interface for single and double left clicks in line with modern GUI standards. (Clicking on an icon will also display a file's tags)
  • Locational awareness: commands like find-file or magit-status will use the location of the node at point (with $HOME as fallback)
  • Optionally fontifying files based on their git status.
  • Optionally collapsing single-dir-child directories into one.
  • Doing both asynchronously for an imperceptible performance cost.
  • Optional follow-mode to automatically focus the currently selected file or tag.
  • Optional filewatch-mode to automatically refresh the view after (and only after) changes to the shown filesystem.

8 Fonts

8.1 Unicode-fonts


This layer adds support for the unicode-fonts package. It is recommended to install the fonts listed in the Quickstart section of the unicode-fonts README.


  • Display unicode glyphs using the best available font.
  • Easily override glyphs or sections of glyphs.
  • Display color emoji on both the macOS port version of Emacs and emacs-plus (with unicode-fonts-force-multi-color-on-mac set to non nil).

9 Fun

9.1 Emoji


This layer adds support for Emoji emoticons from emoji-cheat-sheet.


  • Browse Emoji in a dedicated buffer
  • Display Emoji images in buffer
  • Insert one or several Emoji with a helm front-end
  • Completion of Emojis using company-emoji

9.2 Games


This layer allows you to play evilified games in Spacemacs.


  • 2048-game
  • Pacmacs (Pacman for Emacs)
  • Sudoku
  • Tetris
  • Typit

9.3 Selectric


This layer makes your Emacs sound like an IBM Selectric typewriter, for those moments when your loud, clicky mechanical keyboard is not at hand, yet, you'd still wish to enjoy the sound.


  • Brings back fond memories about your first programming job where you started with that big mechanical keyboard and the small monochrome display working on the latest IBM Iseries server.

9.4 Xkcd


This layer adds a xkcd navigation mode using emacs-xkcd.


  • Load a random xkcd
  • Show the text in the modeline
  • Open explanation and current comic in browser
  • Cache the comics in .cache/xkcd

10 Internationalization

10.1 Chinese


This layer adds support for traditional Chinese script to Spacemacs.


10.2 Japanese


This Layer adds Japanese related packages.


  • evil-tutor-ja: Japanese Vimtutor adapted to Emacs+Evil and wrapped in a major mode
  • migemo: Japanese incremental search through dynamic pattern expansion
  • helm-migemo-mode: helm with migemo
  • avy-migemo: avy with migemo
  • ddskk: Simple Kana to Kanji conversion program (SKK)
  • japanese-holidays: calendar functions for the Japanese calendar
  • pangu-spacing: emacs minor-mode to add space between Japanese and English characters.
  • Join consecutive Japanese lines into a single long line without unwanted space when exporting org-mode to html.

10.3 Keyboard-layout


This layer configures some key bindings in Spacemacs, to make it compatible with keyboard layouts that differs from the traditional en-us QWERTY layout.


  • Support alternative keyboard layouts within Spacemacs
  • Remap navigation commands to the homerow of your chosen layout
  • Remap missing commands automatically to elsewhere in the layout

11 Miscellaneous

11.1 Copy-as-format


This layer adds support for copy-as-format.


  • Function to copy buffer locations as GitHub/Slack/JIRA/HipChat/… formatted code

11.2 Ietf


The IETF layer collects various useful packages for participating in the Internet Engineering Task Force (


  • Fetching and opening IETF documents.
  • Viewing IETF documents.
  • Writing IETF documents.

11.3 Multiple-cursors



  • support for multiple cursors.

11.4 Nlinum


This layer provides various styles of line numbering in Spacemacs. It replaces linum and linum-relative with the improved nlinum and nlinum-relative packages.

Please note that on Emacs 26 and newer, this layer also replaces the new native line numbers mode (display-line-numbers-mode), and because of that it is not recommended to use nlinum layer on Emacs 26 or newer.


  • Support for classic ascending line numbering.
  • Support for line numbering relative to the current cursor position.

11.5 Parinfer


This layer provides an implementation of parinfer, a lisp editing paradigm that controls indentation based on parentheses or vice versa.


  • Automatic management of parenthesis in clojure, emacs lisp, common-lisp and scheme following the parinfer editing paradigm.

11.6 Spacemacs-completion


This layer does basic setup for completion frameworks like helm, ivy and ido.

Its main role is to ensure sane defaults and consistent UI between helm and ivy because even when you are using only one of them you could still need to use the other (for instance a package that supports only helm).

Advanced configuration of these packages can be found in their respective layers in +completion layer directory.


  • Base preconfiguration of helm and ivy for other layers to use.
  • Basic support for ido-navigation configuration and transient state.

11.7 Spacemacs-defaults


This layer configures mostly Emacs built-in packages to given them better defaults.


  • Configures packages:
    • abbrev
    • archive-mode
    • bookmark
    • conf-mode
    • dired
    • dired-x
    • display-line-numbers (only in Emacs 26.x and newer)
    • electric-indent-mode
    • ediff
    • eldoc
    • help-fns+
    • hi-lock
    • image-mode
    • imenu
    • linum (only in Emacs 25.x and older)
    • occur-mode
    • package-menu
    • page-break-lines
    • process-menu
    • recentf
    • savehist
    • saveplace
    • subword
    • tar-mode
    • uniquify
    • url
    • visual-line-mode
    • whitespace
    • winner
    • zone

11.8 Spacemacs-editing


This layer adds packages to improve editing with Spacemacs.


  • Support for automatic indentation of code via aggressive-indent.
  • Support for jumping to chars using a decision tree via avy.
  • Improvements for evaluating sexps via eval-sexp-fu.
  • Selecting and editing of multiple text elements via expand-region.
  • Support for editing files in hex format via hexl.
  • Deletion of consecutive horizontal whitespace with a single key via hungry-delete.
  • Support for selecting, copying and opening links using avy via link-hint.
  • Adding of sample text via lorem-ipsum.
  • Transient state for moving text via move-text.
  • Support for folding of code via origami.
  • Support for password generation via password-generator.
  • Support for improving parenthesis handling via smartparens.
  • Automatic whitespace cleanup on save via spacemacs-whitespace-cleanup.
  • Support for converting definitions to certain styles via string-inflection.
  • Support for generating UUIDs via uuidgen.
  • Support for conversion between Emacs regexps and PCRE regexps.

11.9 Spacemacs-editing-visual


This layer defines a lot of functions used to visually enhance the currently edited line in Spacemacs.


  • Adaptive wrapping
  • Hiding of comments
  • Highlighting of columns longer than 80 chars
  • Highlighting of different indentations
  • Automatic highlighting of numbers
  • Automatic highlighting of parentheses

11.10 Spacemacs-evil


This layer adds various adjustments to packages to create an evilified experience throughout the entirety of Spacemacs.


  • Add evil tutorial with evil-tutor
  • Add relative line number with linum-relative (only in Emacs 25.x and older)
  • Add escaping under fd by default with evil-escape
  • Add occurrences count in mode-line when searching a buffer
  • Add support for lisp structure manipulation with evil-lisp-state
  • Add safe structural editing of lisp dialects with evil-cleverparens
  • Add evil-exchange to swap text
  • Add easy live editing of multiple occurrences with evil-iedit-state
  • Add new vim text objects for indentation with evil-indent-plus
  • Add operations to align text with evil-lion
  • Easy management of comments with evil-nerd-commenter
  • Navigation between pairs with evil-matchit
  • Advanced navigation on brackets with evil-unimpaired
  • Easy increment and decrement of numbers with evil-number
  • Support for additional vim movements via evil-args
  • Support for surrounding the marked area with a given character via evil-surround
  • Evilification of various modes if the editing style is vim or hybrid
  • Improves the comment function to be able to also do the inverse operation
  • Persistent highlight of searched text with evil-search-highlight-persist
  • Display tildes in non-buffer area with vi-tilde-fringe

11.11 Spacemacs-language


This layer adds support various language related services to Spacemacs.


11.12 Spacemacs-layouts


This layer adds support for distinct layouts/workspaces to Spacemacs.


  • Support for distinct layouts via eyebrowse
  • Integration with helm and ivy to search for buffers within layouts

11.13 Spacemacs-misc


This layer adds some general packages into Spacemacs.


  • Support for jumping to definitions via dumb-jump or evil-goto-definition.
  • Support for an easy http request client via request.

11.14 Spacemacs-modeline


This layer adds various mode-lines to Spacemacs.


  • Display of a vim-powerline like mode-line being able to show various information like
    • Current battery status
    • All active minor modes displayed as unicode symbols
    • The active major mode
    • The current branch if the file is in version control
    • The current cursor position
    • The system clock
  • Display of a small system monitor in a separate mode-line.

11.15 Spacemacs-navigation


This layer adds general navigation functions to all supported layers.


  • Support for ace-links in
    • spacemacs buffer
    • info-mode
    • help-mode
    • eww-mode
  • Support for keeping the cursor centered on the screen
  • Evilified version of doc-view-mode
  • Tweaks for golden-ratio-mode
  • Support for paradox a modern emacs package manager
  • Shortcuts for restarting emacs
  • Shortcuts for easily switching between windows

11.16 Spacemacs-org


This layer tweaks org-mode to integrate nicely into Spacemacs.


  • Configuration for flyspell to check org-buffers for typos.
  • Support for automatically generated Table-Of-Contents via toc-org.
  • Support for custom bullet markers via org-bullets.
  • Support for a special view mode for org documents via space-doc.

11.17 Spacemacs-project


This layer tweaks projectile to integrate nicely into Spacemacs.


  • Setup of projectile key bindings, including functions for project search, switching, version control and compilation.
  • Additional path helper functions, to copy the location of a buffer relative to the project root.

11.18 Spacemacs-purpose


This layer enables window-purpose, which provides an alternative, purpose-based window manager for Emacs. With this layer, your window layout should be robust and shouldn't change too much when opening all sorts of buffers.

Regular popwin is not triggered when window-purpose is enabled. However, the window-purpose layer provides a purpose-popwin extension, which brings popwin's behavior to window-purpose and solves that problem.


  • Window layout is more robust and less likely to change unintentionally
  • Dedicate window to a purpose
  • User-defined purposes
  • Extensible window display behavior
  • Empty purpose-mode-map, to avoid conflicts with other key maps
  • Replicate popwin behavior for purpose-mode - almost no regression in popup behavior from using window-purpose.
  • Reuses popwin's settings: popwin:special-display-config, popwin:popup-window-height and popwin:popup-window-width.
  • Difference from popwin: when several windows are open, popup window is sometimes bigger than with regular popwin in the same situation.

11.19 Spacemacs-visual


This layer adds various modes to enhance Spacemacs visual appearance.


  • Automatic colorization of compilation buffers via ansi-colors.
  • Support for resuming the last layout when starting Spacemacs via desktop.
  • Support for showing a thin vertical line to indicate the fill column via fill-column-indicator.
  • Automatic highlighting of TODO-tags in programming and text modes via hl-todo.
  • Support for temporary windows which close automatically via popwin.
  • Support for text zooming via zoom-frm.

12 Music

12.1 Alda layer


Alda is a music composition language allowing music to easily be written and edited in a text file.

This layer adds key bindings for alda-mode's functions, which allow Alda code to be interpreted and played by the running Alda server. It will also start the Alda server if it is not running.


  • Syntax highlighting for Alda files.
  • Play portions of a buffer, or the entire buffer, through a running Alda server.

12.2 Spotify


This layer integrates an online music service into Spacemacs.


  • Support for listening to music from within Emacs via Spotify.

13 Operating systems

13.1 Nixos


This layer adds tools for better integration of Emacs in NixOS.


13.2 Osx


Spacemacs is not just Emacs plus Vim. It can have macOS key bindings too! This layer globally defines common macOS key bindings.


  • is set to hyper and is set to meta
  • In dired use gls instead of ls
  • Fix separator colors of Spaceline mode-line

14 Pair programming

14.1 Floobits


This layer adds support for the peer programming tool floobits to Spacemacs.


  • Loading of floobits configuration files with fixed commands
  • Creation of floobits workspaces and populating it with content
  • Marking of the current cursor position for all users within the current workspace
  • Follow recent changes by other users

15 Programming languages

15.1 Domain-specific (DSLs)

15.1.1 Coq


This layer adds support for the Coq proof assistant (adapted from spacemacs-coq) to Spacemacs.


  • Syntax highlighting
  • Syntax-checking
  • Auto-completion
  • Debugging of mathematical proofs from within Emacs using a special proof layout
  • Replacement of certain constants with the correct mathematical signs
  • Inserting of certain preconfigured proof elements

15.1.2 Ess (r)


This layer adds support for statistical programming languages to Spacemacs.


  • Syntax highlighting
  • Auto-completion
  • Syntax-checking via lintr
  • Additional data viewer for R via ess-R-data-view
  • Support for Org-Babel
  • Showing of inline help for R constructs
  • Repl support via R terminal
  • Support for S, SAS and R
  • Much more via the ESS Project

15.1.3 Extra languages


This layer adds a number of packages for less common languages and major modes.


  • Support for:
    • Arch Linux PKGBUILDs
    • Arduino
    • Android Logcat (not associated with any file types by default)
    • Gentoo ebuilds
    • Hoon
    • MATLAB
    • QML
    • OpenScad
    • Stan
    • Thrift
    • Vala
    • Wolfram Language / Mathematica

15.1.4 Faust


This layer adds support for the faust language to Spacemacs.


  • Syntax highlighting
  • Auto-completion

15.1.5 Gpu


This layer adds support for GPU related languages like CUDA, OpenCL and various Shader formats to Spacemacs.


  • Syntax highlighting for
    • .cl (OpenCL)
    • .cu (CUDA)
    • .cuh (CUDA)
    • .fsh (Shaders)
    • .vsh (Shaders)
    • .glsl (Shaders)
    • .vert (Shaders)
    • .frag (Shaders)
    • .comp (Shaders)
    • .geom (Shaders)
    • .tesc (Shaders)
    • .tese (Shaders)
  • Simple auto-completion via company-glsl for
    • .vert (Shaders)
    • .geom (Shaders)
    • .tesc (Shaders)
    • .tese (Shaders)
    • .frag (Shaders)
    • .comp (Shaders)

15.1.6 Kivy


This layer adds support for Kivy, cross-platform GUI framework for Python.


  • Syntax Highlighting

15.1.7 Mercury


This layer adds support for the Mercury language.


  • Indentation.
  • Syntax highlighting.
  • Compiling and running.

15.1.8 Octave


This layer adds support for GNU Octave files to Spacemacs.


  • Syntax highlighting for .m files via octave-mode.
  • REPL support
  • Support for directly running Octave scripts from Emacs.
  • Integration with Octaves documentation search function.

15.1.9 Prolog


This layer adds support for Prolog using the bundled Prolog mode for Emacs. In addition it also adds ediprolog support for better interaction with SWI-Prolog.


  • Designed for SWI-Prolog as a default, but can be used with other Prologs that Prolog mode supports.
  • Interactive consulting and compiling.
  • Auto-formatting.
  • Apropos and help lookup.

15.1.10 Sql


This layer adds support for a wide range of SQL dialects to Spacemacs.


  • Syntax highlighting for the following SQL dialects
    • ANSI
    • DB2
    • Informix
    • Ingres
    • Interbase
    • Linter
    • Microsoft
    • MySQL
    • Oracle
    • Postgres
    • Solid
    • SQLite
    • Sybase
    • Vertica
  • Syntax-checking via sqlint for ANSI SQL.
  • Format code with sqlfmt
  • Snippet insertion for the more general SQL constructs.
  • REPL support via SQLi buffer.
  • Automatic capitalization of keywords.

15.1.11 Lisp dialects

  1. Clojure


    This layer adds support for Clojure language using CIDER.


  2. Common lisp


    This layer provides support for Common Lisp to Spacemacs.


    • Syntax highlighting
    • Auto-completion using company
    • Repl support via SLIME
    • Support for specific lisp navigation styles via common-lisp-mode
    • Support for sbcl backend or any other common-lisp implementation
  3. Emacs lisp


    This layer gathers all the configuration related to emacs-lisp. This should always be in your dotfile, it is not recommended to uninstall it.


    • Auto-completion using company
    • Linting using flycheck integration
    • Linting package file metadata using flycheck-package
    • Repl support via IELM
    • Support for specific lisp navigation styles via emacs-lisp-mode
    • Auto-compile via auto-compile package
    • Debugging via edebug
    • Ert test runner with overseer
    • Nameless package prefix with optional nameless
    • Structurally safe editing using optional evil-cleverparens
    • Visual feedback when evaluation using eval-sexp-fu
  4. Scheme


    This layer adds support for Scheme via Geiser. Note that combined usage of racket-mode and geiser has not been tested.


    • Support the Scheme compiler Chicken
    • Support for the extension language platform Guile
    • Structurally safe editing using optional evil-cleverparens

15.1.12 Markup & configuration

  1. Asciidoc


    This layer adds AsciiDoc markup language support to Spacemacs.


    • asciidoc format support via adoc-mode
    • .adoc files are associated with adoc-mode by default
  2. Bibtex


    BibTeX and BibLaTeX files are a common way to manage bibliographies. The format was original designed to work with LaTeX files and subsequently has been adopted by other markup formats such as MarkDown and Org mode.

    This layer adds support to manipulate BibTeX and BibLaTeX files in Spacemacs.


    • Syntax highlighting for BibTeX and BibLaTeX files.
    • Utilities for automatically adding entries from different data sources.
    • Support for inserting citations in various other modes.
  3. Csv


    This layer adds tools for better integration of CSV files in Spacemacs.


    • Detecting of fields for various separators
    • Aligning of fields
    • Traversal of fields
    • Killing of fields
    • Sorting of rows
    • Transposing of rows/columns
    • Intelligent yanking of fields
  4. Dhall


    This layer adds support for the Dhall Configuration Language, a non-repetitive alternate to YAML.


    • Syntax highlighting for .dhall source files
    • Automatic buffer reformatting on save (configurable)
    • Type error display in side-buffer

    Note: You will need a dhall binary on your PATH. Official releases can be found here.

  5. Graphviz


    This layer adds support for the open-source graph declaration system graphviz to Spacemacs.


    • Syntax highlighting for .dot files
    • Integration of a live-preview of .dot files via graphviz-dot-mode.
    • Control of the graphviz compiler directly from emacs.
    • Support for formatting .dot files automatically.
  6. Html


    This layer adds support for editing HTML and CSS.


  7. Json


    This layer adds support for JSON files with json-mode


  8. Jsonnet


    This layer provides support for Jsonnet template provided by jsonnet-mode.


    • syntax highlighting
    • buffer formatting
    • jump to definition
    • buffer evaluation
  9. Latex


    This layer adds support for LaTeX files with AucTeX.


  10. Markdown


    This layer adds markdown support to Spacemacs.


    • markdown files support via markdown-mode
    • Fast Github-flavored live preview via vmd-mode
    • TOC generation via markdown-toc
    • Completion of Emojis using company-emoji (still needs a way of showing, either using the emoji layer or having a proper font) :clap:
  11. Plantuml


    This layer enables support for plantuml-mode, which provides a major-mode for plantuml. PlantUML is a tool to generate UML diagrams from plain-text.

    For help with how to use plantuml, see the plantuml website and the reference guide.

    The official file extension supported by this layer is .pum. If you want something else, set it in your user-config function of your ~/.spacemacs file.

    For example, the following diagram can be defined as follows:

    JAremko->robbyoconnor : I think the docs can benefit from some kind of illustration
    JAremko<-robbyoconnor : I'm too lazy -- I have actual work to do. I link to the docs. If you can write me a diagram in plantuml, I'll gladly compile and add it.
    JAremko->robbyoconnor : *gives ths diagram*
    robbyoconnor<-JAremko : *robbyoconnor adds it and JAremko is happy*
    robbyoconnor->theOtherPerson : And they thinks it's funny? Yup, they definitely finds it funny. Right?



    • Syntax highlighting
    • Diagram preview in various output formats
    • Embedding into org documents
    • Controlling the Plantuml compiler directly from emacs
  12. Restructuredtext


    The layer adds ReStructuredText (ReST) support to Spacemacs and adds some functions to rst-mode.

    Note: to add Sphinx specific support use the layer sphinx.


    • rst files are supported via Emacs built-in rst.el.
    • Lists are inserted by new functions.
    • Directives can be inserted easily.
    • auto-completion for directives and options via auto-complete-rst.
    • snippet support via yasnippet.
  13. Semantic web


    This layer adds support for RDF files in N3 and Turtle syntax using ttl-mode and for SPARQL queries using sparql-mode.

    SPARQL-mode supports the execution of queries. When first called, you will be prompted for a SPARQL HTTP endpoint in the minibuffer, which defaults to http://localhost:2020/. Once set, it will be used for all subsequent queries in that buffer. Results will be displayed in another buffer in CSV format.


    • Provides an alternative way to search the web using SPARQL queries.
  14. Yaml


    This layer provides support for the YAML file format.


    • Syntax highlighting
    • Syntax checking via flycheck
  15. Yang


    This layer provides support for the YANG file format.


    • Syntax highlighting
    • Syntax checking via flycheck

15.1.13 Scripting

  1. Autohotkey


    Syntax highlighting and Emacs functions for use with AutoHotkey or AutoHotkeyL.

    Using a combined implementation of ahk-mode from Xah Lee's xahk-mode and Robert Widhopf-Fenk's autohotkey-mode. Updated with the latest ahk and ahkl commands found in the latest revision of SciTE4AutoHotkey.

    Contributed and maintained by Rich Alesi.


    • Auto-completion
    • Documentation Lookup
    • Execute Code Snippets
    • Correct Indentation and Commenting
  2. Shell scripts


    This simple layer adds support for shell scripting.

    Supported scripting files:

    Note: For Windows scripting see the layer windows-scripts


  3. Vimscript language


    This layer adds basic support for vimscript and pentadactyl config files.


    • Syntax highlighting
  4. Windows scripting


    This simple layer adds support for the Powershell scripting language as well as support for batch files.


    • Syntax highlighting of powershell .ps1 files via powershell.el
    • Syntax highlighting of batch .bat files via dos.el

15.2 Frameworks

15.2.1 Django


This layer adds support for the Python web framework Django to Spacemacs.


  • Test execution directly from emacs
  • Starting/stopping of the Django test server
  • Starting of an interactive Python shell in the current project for debugging
  • Fixed commands to open various Django specific settings files
  • Automatic deployment with Fabric directly from emacs
  • Control of South database migration tool

15.2.2 Emberjs


This enables helpers for working with Ember.js projects.

This also includes ember-yasnippets. See the README for ember-yansippets for the snippet keys.

To use this, you need to add add a .dir-locals.el file with the following in the root of your ember project:

((nil . ((mode . ember))))

If you do not wish to do the following, you may also just do M-x ember-mode, however it will make things easier.

Additionally, temporary backup, autosave, and lockfiles interfere with broccoli watcher, so they need to either be moved out of the way or disabled.

Add the following to your dotspacemacs/user-config:

(setq backup-directory-alist `((".*" . ,temporary-file-directory)))
(setq auto-save-file-name-transforms `((".*" ,temporary-file-directory t)))
(setq create-lockfiles nil)


  • Ability to easily switch between various files
  • Key bindings for generators and also easily revert generator actions
  • Ability to build, start server, and run tests

15.2.3 Phoenix


This layer adds key bindings for Alchemist's already built in phoenix mode.


  • Key bindings for navigation to files

15.2.4 React


ES6 and JSX ready configuration layer for React It will automatically recognize .jsx files and files with react imported.


  • on-the-fly syntax checking
  • proper syntax highlight and indentation with jsx
  • backend support for autocompletion as in rjsx-mode
  • jsfmt automatic formatting
  • js2-refactor
  • js-doc

15.2.5 Ruby on rails


This layer aims at providing support for the Ruby on Rails framework.


  • Quick file navigation with with projectile-rails
  • Run server
  • Run generators
  • Rake runner
  • Interactive Rails console

15.3 General-purpose

15.3.1 Imperative

  1. Asm


    This layer adds support for Assembly code. The built-in major mode for editing assembly code in Emacs is asm-mode.

    The layer also adds nasm-mode for NASM-specific syntax. Although nasm-mode is intended for NASM, it actually works well with other variants of Assembly in general, and provides Imenu integration so you can jump around with SPC s j.


    • Improved syntax highlighting.
    • Automatic indentation.
    • Auto-completion for symbol in opened buffers.
    • Look up documentation for current instruction at cursor.
    • Imenu integration.
  2. Forth


    This layer adds basic support for the Forth family of languages to spacemacs.


    • Syntax highlighting
    • Showing meaning of objects in context of the current Forth session.
    • Eval of entire files or regions in current Forth session.
    • Passing interactive commands to current Forth session.

15.3.2 Multi-paradigm

  1. C#


    This layer adds support for C# language using the omnisharp-roslyn language server and corresponding omnisharp-emacs package.

    Please report any issues encountered to omnisharp-emacs issue page on github. PRs are welcome too!


    • Syntax checking with flycheck (when syntax-checking layer is used)
    • Support for auto-completion (when auto-completion layer is used)
    • Refactoring
    • Navigation to cross-references
    • Inspecting types in metadata
  2. C/c++


    This layer adds configuration for C/C++ language.


    • Multiple backends support:
    • Support for debuggers realgud and dap (with LSP backend)
    • Support syntax checking via flycheck (syntax-checking layer required)
    • Auto-completion via company (auto-completion layer required)
    • Support code reformatting with clang-format.
    • Support for disassembly of code with disaster.
    • sematic layer integration:
      • Function or variable definition at the bottom
      • Current function cursor is at the top. See stickyfunc-demos for demos in some programming languages.
      • Support common refactoring with semantic-refactor. See srefactor-demos for demonstration of refactoring features.
    • cscope layer integration:
      • code navigation
  3. Crystal


    This layer provides support for the Crystal language.


  4. D language


    This simple layer adds support for the D language to Spacemacs.


    • Syntax highlighting
    • Auto completion via company
    • Syntax checking via flycheck
  5. Dart


    This layer adds support for Dart language, and could be optionally used for Flutter development as well.


    • Syntax Highlight
    • Error checking with flycheck
    • Go to Definition
    • Dart Analyzer integration
    • Key bindings
  6. Elixir


    This layer adds support for Elixir.

    Alchemist brings the Elixir tooling to Emacs and comes with a bunch of features. Lsp-mode brings IDE like features following Language Server Protocol, through elixir-ls

    As Alchemist is no longer maintained, elixir-ls is a preferred solution, even though it has less features at the moment.


    • Powerful IEx integration
    • Mix integration
    • Compile & Execution of Elixir code
    • Inline code evaluation
    • Documentation lookup
    • Definition lookup
    • Smart code completion
    • Elixir project management
    • Integration with company-mode
    • Flycheck support for mix compile
    • Flycheck support for credo
    • Flycheck support for test results
    • Interactive debugger using dap-mode
  7. Erlang


    This layer adds very basic support for Erlang to Spacemacs.


    • Syntax highlighting
    • Syntax checking via Flycheck integration
    • Auto-completion via Company integration
  8. F#


    This layer adds support for F# language using fsharpbinding and fsharp-mode.


    • Syntax highlighting
    • Code completion
    • Flycheck integration
    • REPL
    • Compile/Run/Interpreter and info tooltip shortcuts
  9. Factor layer


    A spacemacs layer for Factor language support.


    • Syntax Highlighting
    • Factor REPL integration
    • Auto-Completion in REPL
    • Scaffolding support
    • Refactoring support
  10. Go


    This layer adds extensive support for the Go programming language.


  11. Groovy


    This layer supports Groovy development in Spacemacs.


    • Basic dabbrev auto-completion with company
    • Auto-generate imports with groovy-imports
    • Groovy REPL integration
  12. Hy


    This layer adds support for the Hy language based on Python.


    • syntax-highlighting
    • Auto-completion
    • Code Navigation
    • Python test runners (see python layer)
    • Virtual Environment using pyvenv and pyenv
    • Org Babel support
  13. Java


    This layer adds support for the Java language.


    • Support for the following backends:
    • Auto-completion using company
    • Linting using flycheck integration
    • Maven and Gradle integration
    • Interactive debugger using dap-mode
  14. Jr concurrent programming language


    This layer adds syntax highlighting for the JR Concurrent Programming Language. JR is the implementation of the SR language for Java.


    • Syntax highlighting
  15. Julia


    This layer adds support for Julia to Spacemacs.


    • Syntax highlighting
    • Repl support
    • Linting
    • Completion
    • Jump-to-definition
    • Documentation on hover
  16. Kotlin


    This layer adds support for Kotlin in Spacemacs


  17. Lua


    This layer adds support for editing Lua.


    • Editing lua files using lua-mode
    • Sending code to a lua REPL
    • Code linting using Luacheck
  18. Nim


    This layer adds support for the multi-paradigm language Nim.


    • Code completion.
    • Jump to definition.
    • Syntax checking.
  19. Ocaml


    This is a very basic layer for editing ocaml files.


    • Syntax highlighting (major-mode) via tuareg-mode
    • Error reporting, completion and type display via merlin
    • auto-completion with company mode via merlin
    • syntax-checking via flycheck-ocaml (or alternatively merlin)
    • dune file syntax highlighting and template insertion via dune-mode
  20. Pact


    This layer adds support for the Pact Smart Contract Language.


    • Syntax highlighting for .pact source files
    • Easy interaction with an embedded Pact REPL
    • Flycheck integration

    Note: You will need a pact binary on your PATH for REPL features to function.

  21. Perl5


    This layer adds support for the Perl5 language.


  22. Perl6


    This layer provides an environment for the Perl 6 Programming Language.


    • Jump to definition & Code completion via ctags-universal
    • Syntax checking via flycheck-perl6 and perl6 -c
    • Syntax highlighting & Syntax indentation via perl6-mode
    • META6.json highlighting via json-mode
    • Provides Evil text objects for:
      • double-angle-brackets
      • corner-brackets
      • single-quotation-marks
      • double-quotation-marks
  23. Php


    This layer adds PHP language support to Spacemacs.


    The gtags layer is recommended to benefit from better eldoc and helm-gtags.

  24. Python


    This layer adds support for the Python language.


  25. Racket


    Adds support for the Racket programming language.


    • Syntax highlighting with racket-mode
    • Test runner
    • Interactive REPL
    • Code navigation with gtags
    • Structurally safe editing using optional evil-cleverparens
  26. Reasonml


    Spacemacs layer for ReasonML, based around reason-mode.


    • Syntax highlighting / indentation
    • Autocomplete (via merlin)
    • Lint / error display (via merlin, and flycheck if syntax-checking layer is enabled)
    • REPL via rtop
    • Auto-formatting (via refmt)
  27. Ruby


    This layer provides support for the Ruby programming language.


    • Version manager (rbenv, rvm or chruby)
    • Integration with bundler
    • Test runner (ruby-test and rspec)
    • Rake runner
    • Linter (rubocop)
    • Interactive REPL and code navigation (robe)
    • Interactive debugger using dap-mode
  28. Rust


    This layer supports Rust development in Spacemacs.


    • Auto-completion and navigation support through lsp or Racer
    • Interactive debugger using dap-mode
    • support for the Rust package manager Cargo
  29. Scala


    This layer adds support for the Scala language to Spacemacs.


    • Syntax highlighting
    • Support for language backend. Either using ENSIME or Metals
    • Auto-completion
    • Syntax-checking
    • Refactoring
    • Incremental compilation
    • Scala Repl
    • Style linting
    • Eldoc integration
    • Test execution directly from Emacs
    • Automatic replacement of ASCII arrows with unicode ones
  30. Sml


    Adds support for the SML programming language to Spacemacs.


    • Syntax highlighting
    • Integration of the SML Repl into Emacs
    • Basic completion of SML forms via sml-electric-space
  31. Swift


    This layer adds support for Apple's Swift programming language, used as a general purpose scripting language.


    • Syntax highlighting with swift-mode
    • Indentation
    • Code navigation using imenu (built-in)
    • Automatic syntax checking with flycheck (available with the syntax-checking layer)
  32. Zig


    This layer adds support for the zig programming language


    • Syntax Highlighting
  33. JavaScript dialects
    1. Coffeescript


      This layer adds support for the CoffeeScript language using coffee-mode.


      • Syntax highlighting
      • Auto-completion with auto-completion layer
      • Syntax checking and linting with syntax-checking layer
      • Org-Babel integration
      • REPL support
    2. Javascript


      This layer adds support for the JavaScript language using js2-mode.


    3. Purescript


      This layer provides basic Purescript editing support for spacemacs.


      • Syntax highlighting through purescript-mode
      • Automatic insert of imports through psc-ide-emacs
      • REPL through psci
      • Syntax checking through flycheck
      • Autocompletion through company
    4. Typescript


      This layer adds support for TypeScript and TSX editing.


      • Multiple backends support: Tide and LSP
      • Eldoc-mode
      • Documentation at point
      • Auto complete
      • Flycheck with either tslint or eslint
      • Jump to definition, Jump to type definition
      • Find occurrences (Imenu-mode)
      • Rename symbol
      • tsx mode
      • formatting
      • TypeScript playground integration

15.3.3 Purely functional

  1. Agda


    This layer adds support for the Agda programming language.


    • Faces redefined to correctly play with themes.
    • Spacemacs bindings to Agda's interactive tools.

    This layer is in construction, it needs your contributions and bug reports.

  2. Elm


    This layer adds support for Elm.

    It relies on elm-mode and flycheck-elm.


    • Syntax highlighting.
    • Intelligent indentation
    • Auto-completion integration for company (default) or auto-complete modes, with using elm-oracle
    • Syntax checking support using flycheck
    • Integration with elm-make
    • Integration with elm-repl
    • Integration with elm-reactor
    • Integration with elm-package
  3. Haskell


    This layer adds support for the Haskell language.


    This layer is under construction, it needs your contributions and bug reports.

  4. Idris


    This layer adds support for the Idris language to Spacemacs.


    • Syntax highlighting
    • Syntax checking via flycheck
    • Integration of the Idris REPL
    • Integration of the Idris build system

15.4 Utilities

15.4.1 Conda layer


This layer adds support for the Anaconda python environment for numerical computations to Spacemacs.


  • Controlling Anaconda or Miniconda environments directly from emacs with conda.el

15.4.2 Dotnet


This layer adds support for the dotnet cli package.


  • dotnet operations

15.4.3 Ipython notebook


This layer adds support for the package emacs-ipython-notebook.

Do not hesitate to check the original package README here. Also the wiki has lots of informative stuff.


  • Key bindings available through transient-state or leader key
  • Lazy-loading

15.4.4 Protocol buffers


Highlighting and syntax checking for Protocol Buffer files.


  • Syntax highlighting
  • Syntax checking using Flycheck (protoc compiler must be available)
  • Correct indentation and commenting
  • Quickly browse file contents using imenu (default key binding SPC j i).

15.4.5 Sailfish os developer


This layer adds support of sailfish-os development packages.


16 Readers

16.1 Dash


This layer integrates offline API browsers into Emacs. It provides one for macOS, Linux and Windows.


  • Searching for word at point in offline API browser's UI.
  • Integration of offline API browser search results in Helm and Ivy.
  • Support for dash offline API browser for macOS.
  • Support for zeal offline API browser for Linux.

16.2 Deft


This layer adds a search driven note taking system into Spacemacs.


  • Browsing and creating notes with a powerful search function via Deft.
  • Integration of org-mode as note editor.
  • Configurable list of extensions to recognize as notes.

16.3 Elfeed


This layer integrates a web feed reader into spacemacs.


  • Support for reading RSS and Atom feeds directly within emacs via Elfeed.
  • Support for managing feeds via org files supplied by elfeed-org.
  • Support for displaying feed database content in the browser via web interface.

16.4 Epub


This layer provides support for reading EPUB-formatted eBooks in Spacemacs using the excellent nov.el package.


  • Basic navigation (jump to TOC, previous/next chapter)
  • Remembering and restoring the last read position
  • Jump to next chapter when scrolling beyond end
  • Renders EPUB2 (.ncx) and EPUB3 (<nav>) TOCs
  • Hyperlinks to internal and external targets
  • Supports textual and image documents
  • View source of document files
  • Metadata display
  • Image rescaling

16.5 Pdf


This layer enables support for PDF with the pdf-tools package.

According to the official repository:

"PDF Tools is, among other things, a replacement of DocView for PDF files. The key difference is, that pages are not pre-rendered by e.g. ghostscript and stored in the file-system, but rather created on-demand and stored in memory."


  • Searching and slicing with occur.
  • Show document headings in outline buffer.
  • Manipulate annotations.
  • Fit PDF to screen.

16.6 Speed reading


A speed reading mode for Emacs.


  • Support for speed-reading of arbitrary texts

17 Source control

17.1 Git


This layers adds extensive support for git to Spacemacs.


New to Magit? Checkout the official intro.

17.2 Github


This layers adds support for GitHub.


  • forge: integration with various forges, such as GitHub and GitLab.
  • gist.el: full-featured mode to browse and post GitHub gists.
  • git-link: quickly generate URLs for commits or files.
  • github-clone allows for easy cloning and forking of repositories.

17.3 Perforce


This layer integrates Perforce SCM system into Spacemacs.


  • Support for running Perforce (p4) SCM commands directly from Emacs.

17.4 Version-control


This layers adds general configuration for Emacs VC. It should work with all VC backends such as Git, Mercurial, Bazaar, SVN, etc…


  • highlights uncommitted changes in the fringe or margin with diff-hl, git-gutter, or git-gutter+
  • adds vcs transient-state SPC g. to allow quick navigation and modification of buffer hunks.

18 Spacemacs

18.1 Distributions

18.1.1 Spacemacs distribution


This is the default distribution for Spacemacs.


  • Easy access to the Spacemacs experience by adding below auxiliary layers to the base distribution.
    • helm
    • treemacs
    • spacemacs-completion
    • spacemacs-layouts
    • spacemacs-editing
    • spacemacs-editing-visual
    • spacemacs-evil
    • spacemacs-language
    • spacemacs-misc
    • spacemacs-modeline
    • spacemacs-navigation
    • spacemacs-org
    • spacemacs-purpose
    • spacemacs-visual

18.1.2 Spacemacs-base distribution


This is the base distribution for Spacemacs.


  • Minimalistic approach to Spacemacs, contains only the core packages. Good starting point to make something completely new. This distribution should not be used for a new standalone Spacemacs installation except you have very good reasons to.

18.1.3 Spacemacs-bootstrap distribution


This layer loads the necessary packages for spacemacs to start-up.


  • Loads evil key bindings and macros for auto-evilifcation of maps
  • Loads holy and hybrid modes
  • Loads the official Spacemacs theme
  • Loads use-package which is used to load other packages more easily
  • Loads hydra which is used to create transient modes
  • Loads which-key which is used to show key bindings in other modes
  • Loads async which is used to run background processes
  • Loads bind-map and bind-key which are used to realize various Spacemacs specific key binding commands

18.1.4 Spacemacs-docker distribution


Spacemacs distribution that aims to automate dependency installation for Spacemacs layers and provide well tested Docker based development environment with GUI support on all major platforms and even your web browser.


  • Automatically get Spacemacs layers dependency installed with installer scripts
  • Reap the benefit of Emacs and other GNU/Linux tools on Windows or macOS machines
  • Use docker hub to auto-build your environment and store full backups for free
  • Build once and work with the same development environment everywhere
  • Run untrusted/risky code in the tunable sandbox with CPU/network/disk quotas
  • Try new tools, experiment and roll back changes when something goes wrong
  • Share your setup with others or extend someone else's development environment
  • Run multiple Emacs instances on the same machine isolated
  • pause container to free resources temporarily
  • Checkpoint & Restore - maybe the fastest way to start a "heavy" environment
  • Friendly for networks with low upload speed/quotas.

19 Tagging

19.1 Cscope


This layer provides bindings for using Cscope and PyCscope in Spacemacs.

See here for a comparison between Cscope and other similar tools (such as gtags).


  • Tag indexing and searching for C-C++ via Cscope
  • Tag indexing and searching for python via PyCscope

19.2 Helm gtags


counsel-gtags, helm-gtags and ggtags are clients for GNU Global. GNU Global is a source code tagging system that allows querying symbol locations in source code, such as definitions or references. Adding the gtags layer enables both of these modes.


  • Select any tag in a project retrieved by gtags
  • Resume previous helm-gtags session
  • Jump to a location based on context
  • Find definitions
  • Find references
  • Present tags in current function only
  • Create a tag database
  • Jump to definitions in file
  • Show stack of visited locations
  • Manually update tag database
  • Jump to next location in context stack
  • Jump to previous location in context stack
  • Jump to a file in tag database
  • Enables eldoc in modes that otherwise might not support it.
  • Enables company complete in modes that otherwise might not support it.

20 Themes

20.1 Colors


This layer colors your life by enhancing the existing coloration of identifiers as well as providing you with a more colorful process indicator.


  • Colorize all identifiers (Christmas tree mode :-)) with mostly unique colors, and the ability to choose saturation and lightness with rainbow-identifiers.
  • Colorize only identifiers recognized as variables with color-identifiers.
  • Colorize strings representing colors with the color they represent as background with rainbow-mode.
  • Display a Nyan cat progress bar in the mode-line with nyan-mode.

20.2 Nyan-mode


Nyan Mode - Turn your Emacs into Nyanmacs! :) The mode is an analog indicator of your position in the buffer. The Cat should go from left to right in your mode-line, as you move your point from 0% to 100%.


  • Mind dumbing content included,
  • Experimental animation (M-x nyan-start-animation, M-x nyan-stop-animation),
  • Wavy rainbow (M-x set-variable <ret> nyan-wavy-trail <ret> t),
  • Music, mplayer is needed (M-x nyan-start-music, M-x nyan-stop-music),
  • Customizable properties.

20.3 Themes megapack


This layer installs around 100 themes for Emacs.


  • Have access to all included themes in this theme gallery from Rob Merrell.
  • Easily try a theme by invoking helm-themes with: SPC T s.

20.4 Theming


This layer allows for a simple way of modifying themes.


  • Modify themes from your .spacemacs.
  • Tweak face attributes and other aspects of themes.
  • Includes three additional layer variables for tweaking headings.

21 Tools

21.1 Ansible


This layer adds support for editing Ansible configuration files in Spacemacs.


  • Syntax highlighting for Ansible-flavored YAML and Jinja2 templates.
  • Auto-completion via company-ansible.
  • Integration of ansible-vault into emacs for automatic encryption/decryption of files.

21.2 Bm


BM provides visible, buffer local, bookmarks and the ability to jump forward and backward to the next bookmark.


  • Auto remove bookmark after jump to it by bm-next or bm-previous
  • Cycle through bookmarks in all open buffers in LIFO order
  • Toggle bookmarks. Jump to next/previous bookmark.
  • Setting bookmarks based on a regexp. (Useful when searching logfiles.)
  • Mouse navigation.
  • Annotate bookmarks.
  • Different wrapping modes.
  • Different bookmarks styles, line-only, fringe-only or both.
  • Persistent bookmarks.
  • List bookmarks (in all buffers) in a separate buffer.
  • Cycle through bookmarks in all open buffers.

21.3 Cfengine


This layer adds support for CFEngine policies to Spacemacs.


  • Syntax highlighting
  • On the fly syntax checking via flycheck integration.
  • Auto completion via company integration.
  • Execution of cfengine3 SRC blocks in org-mode via ob-cfengine3 package.

21.4 Chrome


This layer provides some integration with the Google Chrome browser.


  • Edit text boxes with Emacs using edit-server
  • Write markdown in Emacs and realtime show in chrome using flymd
  • gmail message mode uses standard markdown key bindings

21.5 Cmake


This layer adds support CMake scripts.


  • Support for CMake configure/build (with limited support for other build systems), automatic generation of compile_commands.json (compile flags), on-the-fly configuration of flycheck, company-clang and RTags (if installed) with cmake-ide.
  • Run selected test using Helm interface via helm-ctest.

21.6 Command-log


This layer adds a handy command demonstration mode to Spacemacs.


  • Support for logging all entered keys and triggered commands in a designated buffer via command-log-mode.
  • Provides the best way to demonstrate the connection between keystrokes and commands in Emacs.
  • Provides an easy way to create command logs for training classes.

21.7 Dap


Experimental integrated visual debugger using Debug Adapter Protocol.

Debug Adapter Protocol is a wire protocol for communication between client and Debug Server. It similar to the LSP but providers integration with debug server.


Fully featured IDE-like debugger providing:

  • Launch/Attach
  • Breakpoints
  • Exceptions
  • Pause & Continue
  • Step In/Out/Over
  • Callstacks
  • Threads
  • Multiple simultaneous debug sessions
  • Evaluating statements
  • Debug/Run configurations
  • Debug REPL

21.8 Debug


This layer adds interactive debuggers for multiple languages using realgud.


  • Modern rewrite of the Emacs GUD debugger family
  • Visual interface including breakpoint and line indicators
  • Advanced features like stack frame navigation and mouse support
  • Extensible framework for adding your own external debuggers

21.9 Docker


This layer integrates basic container management into Spacemacs.


  • Syntax highlighting for Docker files
  • Docker build integration
  • TRAMP access to running Docker containers
  • Docker container and image management via docker.el
  • docker-compose integration via docker.el
  • Syntax checking via hadolint

21.10 Fasd


This layer integrates the fasd command line tool into Spacemacs.


  • Adds easy shortcuts to reference recent files and directories.
  • Provides fasd with recent open file lists from Emacs.
  • Allows to filter fasd results with helm or ivy.

21.11 Finance


This layer integrates a full fledged accounting system into Spacemacs.


  • Support for maintaining a double-entry accounting system run by text files via ledger-mode.
  • Display of finance reports directly within Emacs.
  • Integration of Emacs calculator mode for editing post amounts.
  • Support for easy account reconciliation via Ledger-Reconcile.
  • Extended support for evil style editing with evil-ledger.

21.12 Geolocation


This layer offers location sensitive adjustments to Emacs.


  • Supports the following adjustments:
    • Automatic switching between light (day) and dark (night) themes via theme-changer
    • Local weather forecast via sunshine
    • Integration with macOS's CoreLocation service via osx-location
    • Manual location setting via variables in your dotfile

21.13 Imenu-list


This layer uses imenu-list to show the current buffer's index in a side bar.

This is similar to `SPC j i` but displayed in a persistent sidebar instead of a completion buffer.


  • IDE like outline view of current buffer showing all significant symbols in one view

21.14 Import-js


This layer adds support for import-js


  • Import Javascript/Typescript modules to buffer
  • Import missing modules and remove unused one
  • Go to module location

21.15 Lsp


This layer adds support for basic language server protocol packages speaking language server protocol.

Different language servers may support the language server protocol to varying degrees and they may also provide extensions; check the language server's website for details. M-x lsp-describe-session in a LSP buffer to list capabilities of the server.


  • Cross references (definitions, references, document symbol, workspace symbol search and others)
  • Workspace-wide symbol rename
  • Symbol highlighting
  • Flycheck
  • Completion with company-lsp
  • Signature help with eldoc
  • Symbol documentation in a child frame (lsp-ui-doc)
  • Navigation using imenu
  • Consistent core key bindings in LSP modes

21.16 Nginx


This layer adds support for configuring nginx a powerful alternative for the Apache web server.


  • Syntax highlighting of nginx configuration files via nginx-mode.
  • Syntax-aware indentation

21.17 Node


This layer introduces packages that target Node.js. Currently this layer should not be used directly, as it will be used by other layers.


  • Integration of packages necessary to execute node.js modules from other layers.

21.18 Pandoc


This layer adds support for Pandoc.

Pandoc is a universal document converter. It makes it easy to e.g. convert a Markdown file to org mode or vice versa. It can also export your text to PDF or DOCX.


  • Mode independent document conversions via global pandoc menu
  • Org-export integration via ox-pandoc

21.19 Pass


This layer adds integration with pass, the unix password manager. You must have pass installed and available in your path for this layer to function properly.


  • Use Spacemacs as your password manager

21.20 Prettier


This layer adds support for prettier


  • Format buffer in a consistent style

21.21 Prodigy


This layer adds support for the prodigy package to manage external services from within Emacs, check the package's documentation for more details.

It is recommended to put your prodigy services in the dotspacemacs/user-config part of your ~/.spacemacs file.


  • Managing of pre-declared services from within Emacs
  • Showing of process output in special buffers
  • Filtering of processes for tags or names

21.22 Puppet


This layer provides support for the Puppet DSL to Spacemacs.


  • Syntax highlighting via puppet-mode
  • Syntax-checking via puppet-lint
  • Navigation commands to jump between blocks
  • Applying the content of the current manifest directly from Emacs

21.23 Ranger


This layer brings Ranger features to spacemacs from the ranger package.

To use this configuration layer, add it to your ~/.spacemacs. You will need to add ranger to the existing dotspacemacs-configuration-layers list in this file.

To default with preview enabled when entering ranger:

(setq-default dotspacemacs-configuration-layers
              '(ranger :variables
                       ranger-show-preview t))


  • use ranger to display dired with ranger like preview and stacked parent windows.

21.24 Rebox


This layer adds support for rebox2 package which is a minor-mode allowing to easily add ASCII text boxes to a buffer.

A nice video demonstration by the package author can be found here.


  • Auto-wrap correctly in comments,
  • Auto-fill correctly in comments,
  • Boxes auto-adapt as text is inserted or deleted,
  • S-RET to continue a comment on the next line,
  • Kill/yank within the box,
  • Apparently works well with ancient filladpt-mode (see authors video).

21.25 Restclient


This layer provides a REPL-like interface for http requests.


21.26 Saltstack


This layer provides syntax highlighting for Saltstack files.


  • Syntax highlighting
  • Display of salt documentation

21.27 Shell


This layer configures the various shells available in Emacs.


  • Shell integration

21.28 Sphinx


The layer adds support for the documentation generation system Sphinx to the restructuredtext layer.


  • Support for Sphinx project compilation
  • Support for opening Sphinx project target
  • Support for opening Sphinx config file

21.29 Systemd


This layer adds support for editing systemd configuration files in Spacemacs.


  • Syntax highlighting
  • Auto completion
  • Syntax checking via systemd-analyze

21.30 Tern


This layer adds support for tern stand-alone code-analysis engine for JavaScript.


  • TODO: list the feature of tern supported by tern package

21.31 Terraform


This layer provides basic support for Terraform .tf files.


  • Basic syntax highlighting via terraform-mode
  • Auto formatting on save via terraform fmt

21.32 Tmux


This layer adds basic tmux key bindings to Spacemacs.


21.33 Transmission


This layer integrates a BitTorrent client into Spacemacs.


21.34 Vagrant


This layer adds support for working with Vagrant using vagrant.el and vagrant-tramp.


  • Manage boxes (under the SPC a V prefix)
  • Remote editing on Vagrant boxes via Tramp

21.35 Web-beautify


This layer adds support for web-beautify.


  • Format buffer to be beautiful

21.36 Xclipboard


xclipboard integration layer.


  • adds copy support to the X-clipboard from the terminal.
  • adds paste support to the X-clipboard from the terminal.
  • cliphist package: integration with clipboard managers on Linux and macOS.

22 Vim

22.1 Evil-commentary


This layer replaces evil-nerd-commenter with evil-commentary for those who prefer the behaviour of vim-commentary.


  • Provides the original vim behaviour for commenting out lines via evil-commentary.

22.2 Evil-snipe


This layer adds various replacements for vim's default search functions.


  • Alternative implementation of vim's default search operations.
  • Replacement of evil-surround with a two-character search.
  • Support for alternative scopes for default search operations.
  • Support for alternative motions based on configurable regexps.

22.3 Vim-empty-lines


This layer is a drop-in replacement for the vi-tilde-fringe mode, for those who desire behaviour closer to vim's.

It has better compatibility with retina displays, as it uses a text overlay using your font, rather than a pixel-art tilde. The empty line indicators are overlaid in within the buffer as in vim, and not in the fringe. The indicator behaviour with trailing empty lines matches vim's behaviour.

For details, see the vim-empty-lines-mode repository.


  • Emulation of original vim behaviour.
  • Brings you as close to vim as one can be without using vim itself.

22.4 Vinegar


This layer is a port of vim-vinegar for Emacs.

It is based on tpope's vinegar.vim, simplifying dired with a limited number of details and exposing the - command in all buffers to enter dired.


  • navigation up folders with - key
  • simplify dired buffer to show only file names
  • better evil/vim bindings for navigation within dired buffer
  • keep only one active dired buffer
  • Use dired-k extension to show time / vcs related information in single bar
  • right mouse click moves up directory if in blank space or shows context menu

23 Web services

23.1 Confluence


This layer adds support for Atlassian Confluence.


  • Creating/editing of Confluence pages
  • Exporting of org buffers to Confluence wiki format

23.2 Evernote


This layer adds support for the famous Evernote note taking service to Spacemacs. It does so by grouping together various packages to work with Evernote.


  • Create notes in markdown and sync with Evernote via geeknote.
  • Search for notes using keywords
  • Move notes between notebooks

23.3 Search engine


This layer adds support for the Search Engine package.


  • Browser search integration

23.4 Twitter


This layer adds Twitter support to Spacemacs via the package twittering-mode.


  • Activities on Twitter
    • Viewing various timelines
      • Home timeline
      • Replies
      • User's timeline
      • Public timeline
      • Favorites timeline
      • Retweets timeline
      • Merged timeline
      • Timeline without tweets satisfying a condition
    • Posting tweets
      • Direct message
      • ReTweet
      • Hash tag
      • Signature
    • Following and removing users
    • Marking tweets as favorites
  • HTTP Proxy support
  • Secure connection via HTTPS (cURL, GNU Wget, OpenSSL or GnuTLS is required)

23.5 Wakatime


This layer adds support for Wakatime.

WakaTime was built to solve time tracking for programmers. Since we work inside a text editor, why should we have to start and stop a timer? WakaTime uses open-source text editor plugins to automatically track the time you spend programming so you never have to manually track it again!

P.S. wakati means time in Swahili


  • Integration with Wakatime cloud based time tracking service

Author: root

Created: 2019-11-10 Sun 14:17