Adds grammar support for Markdown (including Github flavored, AtomDoc, Markdown Extra, CriticMark, YAML/TOML front-matter, and R Markdown), and smart context-aware behavior to lists, and keyboard shortcuts for inline emphasis.
Markdown grammar
A realistic implementation of various Markdown specifications as a flexible, drop-in alternative for language-gfm. Adds smart context-aware behavior to lists, and keyboard shortcuts for inline emphasis and links/images.
Installation
- Install
language-markdownvia either
- your terminal:
apm install language-markdown - the Atom GUI:
Atom>Settings>Install> Search forlanguage-markdown
- Select
language-markdownas your Markdown grammar. Open a Markdown file and
- press ctrl+shift+L and choose "Markdown"
- choose "Markdown" from the grammar selection interface in the bottom right-hand corner of the window
To avoid conflicts this package tries to disable the core package language-gfm. If you run into any issue, make sure you've selected the correct grammar.
Supported grammars
- CommonMark Markdown
- Github Flavored Markdown (including AtomDoc)
- Markdown Extra
- CriticMark annotation
- Front Matter (yaml, toml and json)
- R Markdown
Additional features
- Smarter lists
- Automatically create new list-items when pressing enter
- Indent or outdent list-items by pressing tab or shift+tab
- Toggle tasks with cmd+shift+x or ctrl+shift+x
- Remove empty trailing list-items when pressing enter
- Add shortcuts (via _, * and ~) for toggling inline-emphasis and strike-through on selected text
- Add shortcuts for converting selected text to a link (via @) or an image (via !)
- Supports embedded
HTML- andLiquid-tags - Embedded math functions (via
language-latexandlanguage-mathematica)
Syntax-theme support
By default, most syntax-themes only provide basic styling for .markup classes. This package provides additional, more specific classes which are supported by the following syntax-themes:
- minimal-syntax (light, high-contrast)
- minimal-syntax-dark (dark, high-contrast)
- pen-paper-coffee (light, low-contrast)
- pubster-syntax (dark, high-contrast)
- one-o-eight-syntax (various, medium-contrast)
- east-end-syntax (light, medium-contrast)
- east-end-notebook-syntax (light/lined, medium-contrast)
If you are interested in adding support for all .markup classes to your syntax-theme, take a look at the relevant section in the contribution guide.
F.A.Q.
If you run into any issues, consult the F.A.Q. first. Amongst other things, this document contains information about common issues involving:
- spell-check
- autocompletion
- syntax-highlighting
- whitespace
Contributing
If you want to contribute to this package, have a look at the contribution guide.