Skip to main content
  1. Posts/

Setting up Yasnippet for Emacs

·458 words·3 mins·
Emacs Snippet
Table of Contents

Unlike Vim/Neovim, where there are snippet engines like ultisnips and other plugins. In Emacs, the de facto snippet engine is yasnippet.

Installation and setup
#

Like vim-snippets for ultisnips, yasnippet-snippets provides the actual snippets for yasnippet.

Yasnippet and yasnippet-snippets can be easily installed via straight.el:

(straight-use-package 'yasnippet)
(straight-use-package 'yasnippet-snippets)

(yas-global-mode t) ;; activate yasnippet

Check available snippets
#

To check the available snippets for the current mode, run command yas-visit-snippet-file and choose snippet to view. You can also run command yas-describe-tables, which will show a list of snippets and their trigger words in a separate buffer.

yasnippet snippet table

The trigger shortcut
#

By default, the shortcut to trigger the expansion of a snippet is Tab. It can be easily changed, e.g., to change the shortcut to Meta-z, add the following config to init.el:

(define-key yas-minor-mode-map (kbd "M-z") 'yas-expand)

Jump forward and backward
#

To jump forward and backward through the tabstop fields/positions, the default is to use Tab and Shift+Tab. You can customize via the following config:

;; use Meta-j and Meta-k to jump between fields
(define-key yas-keymap (kbd "M-j") 'yas-next-field-or-maybe-expand)
(define-key yas-keymap (kbd "M-k") 'yas-prev-field)

Create custom snippets
#

The snippets are usually organized into different modes, which is kinda like filetypes in Vim/Neovim. For custom snippets, we can put under the directory ~/.emacs.d/snippets.

Snippet for a specific mode
#

To create a snippet for markdown-mode, create a directory markdown-mode under ~/.emacs.d/snippets and create a new file there (the file name does not really matter)1. To create a snippet for markdown front matter like what is done here using ultisnips, use the following snippet:

# -*- mode: snippet -*-
# name: meta data
# contributor: jdhao <jdhao@hotmail.com>
# key: meta
# --
---
title: "${1:TITLE}"
date: `(format-time-string "%Y-%m-%dT%H:%M:%S%:z")`
tags: [${2:TAG}]
categories: [${3:CATEGORY}]
---
$0

The key field is the trigger word for this snippet, i.e., you type meta and press the trigger key to expand the snippet. The string inside the two backtick will be interpreted by the Emacs lisp interpreter and the result will be inserted there.

General Snippets (fundamental-mode snippets)
#

To write a snippet applicable to different modes, we can put it under the directory named fundamental-mode.

Check here on how to write a snippet for yasnippet.

Override an existing snippet
#

To override an existing snippet provided by yas-snippets, create a new snippet for the same mode with the same name. For example, to override link, use the following snippet instead:

# -*- mode: snippet -*-
# name: Link
# contributor: jdhao <jdhao@hotmail.com>
# key: link
# --
[${1:TEXT}](${2:URL})

The name field must be the same with the existing snippet you want to override.

References
#


  1. You can also run command yas-new-snippet to create a new snippet. ↩︎

Related

Customize Tabline in Emacs
··244 words·2 mins
Emacs
Straight.el Bootstrap and Package Install Issue
··130 words·1 min
Emacs
Learning Emacs as A Nvimmer in One Day
··1413 words·7 mins
Emacs