casesandberg / emmet-atom

Emmet support for Atom

Emmet plugin Atom editor

Emmet support for Atom.

Installation

In Atom, open Preferences > Packages, search for Emmet package. Once it found, click Install button to install package.

Manual installation

You can install the latest Emmet version manually from console:

cd ~/.atom/packages
git clone https://github.com/emmetio/emmet-atom
cd emmet-atom
npm install

Then restart Atom editor.

Features:

• Expand abbreviations by Tab key.
• Multiple cursor support: most Emmet actions like Expand Abbreviation, Wrap with Abbreviation, Update Tag can run in multi-cursor mode.
• Interactive actions (Interactive Expand Abbreviation, Wrap With Abbreviation, Update Tag) allows you to preview result real-time as you type.
• Better tabstops in generated content: when abbreviation expanded, hit Tab key to quickly traverse between important code points.
• Emmet v1.1 core.

Please report any problems at issue tracker.

Tab key

Currently, Emmet expands abbreviations by Tab key only for HTML, CSS, Sass/SCSS and LESS syntaxes. Tab handler scope is limited because it overrides default snippets.

If you want to make Emmet expand abbreviations with Tab key for other syntaxes, you can do the following:

1. Use Open Your Keymap menu item to open your custom keymap.csom file.
2. Add the following section into it:

'atom-text-editor[data-grammar="YOUR GRAMMAR HERE"]:not([mini])':
    'tab': 'emmet:expand-abbreviation-with-tab'

Replace YOUR GRAMMAR HERE with actual grammar attribute value. The easiest way to get grammar name of currently opened editor is to open DevTools and find corresponding <atom-text-editor> element: it will contain data-grammar attribute with value you need. For example, for HTML syntax it’s a text html basic.

You can add as many sections as you like for different syntaxes. Note that default snippets will no longer work, but you can add your own snippets in Emmet.

Default Keybindings

You can change these Preferences > Emmet.

Command	Darwin	Linux/Windows
Expand Abbreviation	tab or shift + ⌘ + e	tab or ctrl + e
Expand Abbreviation (interactive)	alt + ⌘ + enter	ctrl + alt + enter
Wrap with Abbreviation	ctrl + w	ctrl + alt + w
Balance (outward)	ctrl + d	ctrl + ,
Balance (inward)	alt + d	ctrl + shift + 0
Go to Matching Pair	ctrl + alt + j	ctrl + alt + j
Next Edit Point	ctrl + →	ctrl + alt + →
Previous Edit Point	ctrl + ←	ctrl + alt + ←
Select Next Item	ctrl + shift + →	ctrl + shift + .
Select Previous Item	ctrl + shift + ←	ctrl + shift + ,
Toggle Comment	⌘ + /	ctrl + shift + /
Split/Join Tag	shift + ⌘ + j	ctrl + shift + `
Remove Tag	⌘ + '	ctrl + shift + ;
Evaluate Math Expression	shift + ⌘ + y	ctrl + shift + y
Increment Number by 0.1	ctrl + alt + ↑	alt + ↑
Decrement Number by 0.1	ctrl + alt + ↓	alt + ↓
Increment Number by 1	ctrl + alt + ⌘ + ↑	ctrl + ↑
Decrement Number by 1	ctrl + alt + ⌘ + ↓	ctrl + ↓
Increment Number by 10	ctrl + alt + ⌘ + shift + ↑	shift + alt + ↑
Decrement Number by 10	ctrl + alt + ⌘ + shift + ↓	shift + alt + ↓
Reflect CSS value	shift + ⌘ + r	ctrl + shift + r
Update Image Size	ctrl + i	ctrl + u
Encode/Decode image to data:URL	ctrl + shift + i	ctrl + '
Update Tag	ctrl + shift + u	ctrl + shift + '
Merge Lines	shift + ⌘ + m	ctrl + shift + m

All actions and their keyboard shortcuts are available under Packages > Emmet menu item.

Extensions support

You can easily extend Emmet with new actions and filters or customize existing ones. In Preferences > Emmet, set Extensions path to folder with Emmet extensions. By default, it’s ~/emmet, e.g. emmet folder in your system HOME folder.