HackerReposA FIELD GUIDE TO OPEN SOURCE
ProSponsor the shelf♧ 0
← Back to top all-time
noctuid
evil-guide
Developer Tools2017–2023
noctuid / evil-guide

evil-guide

Draft of a guide for using emacs with evil

3Distinct people
3Mentions
0Explicit recommenders
1.3KGitHub stars
REPOSITORY AT A GLANCE

What to know before exploring

What it is

Draft of a guide for using emacs with evil

GitHub

Where it is used

No documented product use has been verified yet.

What people are saying

No recommendation phrase was found in the indexed comments.

No classified warning is attached to this page. Read the discussions before treating silence as approval.

Also in these discussions

No other repository is repeatedly linked in the same discussions.

This week on Hacker News

Nov 7–Nov 14 UTC · Direct repository links and separately labeled related project stories. Indexed through 11/14/2026, 1:49:46 PM UTC.

No direct repository links were found in the indexed HN discussions over the past seven days. Older discussions are available below.

Mentions over time

HN mentions by year3 dated mentions

Observed mentions: 2017-08-28 19:03:54 UTC to 2023-09-05 01:12:40 UTC.

012017-01-01 00:00:00 UTC to 2018-01-01 00:00:00 UTC (exclusive): 1 mentions; 0 submissions, 1 comments20172018-01-01 00:00:00 UTC to 2019-01-01 00:00:00 UTC (exclusive): 0 mentions; 0 submissions, 0 comments2019-01-01 00:00:00 UTC to 2020-01-01 00:00:00 UTC (exclusive): 0 mentions; 0 submissions, 0 comments2020-01-01 00:00:00 UTC to 2021-01-01 00:00:00 UTC (exclusive): 0 mentions; 0 submissions, 0 comments20202021-01-01 00:00:00 UTC to 2022-01-01 00:00:00 UTC (exclusive): 1 mentions; 0 submissions, 1 comments2022-01-01 00:00:00 UTC to 2023-01-01 00:00:00 UTC (exclusive): 0 mentions; 0 submissions, 0 comments2023-01-01 00:00:00 UTC to 2024-01-01 00:00:00 UTC (exclusive): 1 mentions; 0 submissions, 1 comments2023

Counts come from the repository’s dated source evidence. Index cutoff: 2026-11-02 08:16:59 UTC.

View mention counts and date ranges
UTC ranges include their start and exclude their end. Select a period to filter the source evidence.
PeriodStart (UTC)End (exclusive, UTC)MentionsSubmissionsComments
20172017-01-01 00:00:00 UTC2018-01-01 00:00:00 UTC101
20182018-01-01 00:00:00 UTC2019-01-01 00:00:00 UTC000
20192019-01-01 00:00:00 UTC2020-01-01 00:00:00 UTC000
20202020-01-01 00:00:00 UTC2021-01-01 00:00:00 UTC000
20212021-01-01 00:00:00 UTC2022-01-01 00:00:00 UTC101
20222022-01-01 00:00:00 UTC2023-01-01 00:00:00 UTC000
20232023-01-01 00:00:00 UTC2024-01-01 00:00:00 UTC101

What Hacker News says

3 sources
I am genuinely surprised to see this on the front page. The author has done amazing work with Emacs packages, such as general.el [ https://github.com/noctuid/general.el ], his Evil guide [ https://github.com/noctuid/evil-guide], and many others. I used vim for many years and like everyone else in a similar position, none of the touted "vim emulators" came close at all. They would always only cover a very superficial micro-subset of vim functionality, such as some thin approximation of modes and motions. Inevitably you would come up against a brick wall by doing something which you would otherwise express in vim without giving it a second thought, due to one's fluency, and it would all come crashing down. Once you reach that point, it's very difficult to just "make do" because it becomes blatantly obvious that what you're using is not vim.
Read the rest
In such cases I personally would just revert to the stock editor, because I'd rather use the well made stock editor than a half-hearted attempt at vim emulation that would keep me guessing as to whether or not certain functionality I've come to expect was implemented or not. I used vim for a long time because I truly felt (and still do) that it was the best "editing language" or "interface," as in, the means by which one communicates their intentions to the editor. However, I always felt like it came short in everything else. Options, their names, and their documentation were terse and cryptic. Vimscript felt inconsistent and left something to be desired for me. Overall I _loved_ vim but I felt most people did so _despite_ many failings. When I would see beautifully crafted Emacs packages such as Magit [ https://magit.vc/ ] and how meticulously they were documented [ https://magit.vc/manual/magit/#Top ], I started to become interested in Emacs. The fact that Emacs has a culture of and encourages everything being self-documented is what pushed me over the edge. Every variable, function, keybind, syntax highlighting face, and _much more_ (truly pretty much everything) is and can be documented. Emacs Lisp may not satiate hardcore lispers, but I've found it to be amazingly powerful. I can interactively expand macros to see what's going on at each step with macrostep. There's a built-in interactive debugger. One can "advise" existing functions to add functionality to them (before, after, around, etc.). I've found that the vast majority of package authors are very receptive and accommodating, and in the absolute worst case where they're intransigent or I recognize that it's an edge case that only applies to me, I can confidently, consistently, and safely modify things myself without having to fork the package. I could go on and on. Admittedly however, Emacs out of the box left a _lot_ to be desired for me in terms of cosmetics and keybinds. It's important to remember that many of the keybinds for example were devised back in a time before the now-more-conventional keybinds became, well, conventional. I knew not to be deterred by that though. IMO, the way to think of Emacs is as a language or REPL with which each person creates their _own editor_, _if_ they want to. I fully expect that if I were to sit at someone else's Emacs setup, they would have vastly different binds and modifications, and _yet_ I would feel confident knowing that I could count upon some core primitives such as describe-key and so on, again due to Emacs' self-documenting nature. To call Evil a vim emulator or even a port is to sell it short. It continues to blow my mind how amazing Evil is at _being_ vim. I realize it's blasphemous, but I truly believe that it is a _better vim than vim is_. The ease with which anyone can (and does) define new operators, motions, and text objects is breathtaking coming from vim. Likewise, I worried about losing access to many of the vim packages I used. I quickly found that the self-purported "ports" of the packages (such as evil-surround) were actually _much better_ than their vim equivalents! They could be extended and configured in many more ways than their vim equivalents, and they would _compose_ with many other Emacs constructs out of the box. I continue to be amazed. Despite how great I believe Emacs is, I wouldn't be using it if it weren't for how amazing Evil is. I have come to depend on both, the vim "editing language" and the Emacs environment, but if it came down to it, I would have to choose vim for its editing language. But it's 2017 and nowadays we can have both. The war is over.
In Lispyville: a lisp-editing environment suited towards evil users

MAKE YOURSELF AT HOME

A few shortcuts

/
Search the collection
?
Open this guide
Esc
Close dialogs and navigation

Your saved repositories and interests stay in this browser.