Skip to content
Github emoji in markdown documents and commit messages for Sublime Text 3
Python JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

Github :octocat: Emoji 🐼 for Sublime Text 3

A Sublime Text 3 plugin for inserting github emoji in markdown documents. Also supports commit message emoji


emoji completion

When editing a markdown document type : and then press TAB to display the auto-complete popup for github emoji. You can type @ instead of : for commit message emoji.

Alternatively, for non-commit emoji, you can add this to your auto_complete_triggers in the user preferences:

"auto_complete_triggers": [
    "characters": ":",
    "selector": "text.html.markdown"
  // ...

This way when you type : in markdown documents you'll get the autocompletion popup.

You can customize the available emoji, scopes, and filenames by copying and editing the default settings (Preferences > Package Settings > GithubEmoji > Settings – Default) and saving them into your own user settings (Preferences > Package Settings > GithubEmoji > Settings – User)

You can check available github emoji at the emoji cheat sheet

Note: On linux you will need a font that includes emoji in order to see emoji characters in the auto-complete popup. Here's one


Package Control (preferred)

  1. Install Sublime Package Control
  2. From inside Sublime Text, open Package Control's Command Pallet: CTRL + SHIFT + P (Windows, Linux) or CMD + SHIFT + P on Mac.
  3. Type install package and hit Return. A list of available packages will be displayed.
  4. Type GithubEmoji and hit Return. The package will be downloaded to the appropriate directory.

Manual Installation

Download or clone this repository to a directory GithubEmoji in the Sublime Text Packages directory for your platform:


git clone ~/Library/Application\ Support/Sublime\ Text\ 3/Packages/GithubEmoji


git clone %APPDATA%\Sublime/ Text/ 3/\GithubEmoji


git clone ~/.Sublime\ Text\ 3/Packages/GithubEmoji

Known Issues

  • Emoji characters in the auto-complete popup appear broken for windows 7 and 8.
  • Emoji character colors in OS X (tested on El Capitan) look ...inverted?

Please drop me a line for any other OS specific strangeness or workarounds.


The list of github emoji (emoji.json) is taken from gemoji.

Installation instructions ripped from MarkdownEditing's readme.

Similar Plugins

The Emoji plugin allows you to insert emoji characters from the command palette.

You can’t perform that action at this time.