- Add #+HTML_HEAD_EXTRA options to all org files - HTMLize published documentation via CSS
158 lines
6 KiB
Org Mode
158 lines
6 KiB
Org Mode
#+TITLE: Markdown contribution layer for Spacemacs
|
|
#+HTML_HEAD_EXTRA: <link rel="stylesheet" type="text/css" href="../../../css/readtheorg.css" />
|
|
|
|
[[file:img/markdown.png]]
|
|
|
|
* Table of Contents :TOC_4_org:noexport:
|
|
- [[Description][Description]]
|
|
- [[Features:][Features:]]
|
|
- [[Install][Install]]
|
|
- [[Usage][Usage]]
|
|
- [[Key bindings][Key bindings]]
|
|
- [[Element insertion][Element insertion]]
|
|
- [[Element removal][Element removal]]
|
|
- [[Completion, and Cycling][Completion, and Cycling]]
|
|
- [[Following and Jumping][Following and Jumping]]
|
|
- [[Indentation][Indentation]]
|
|
- [[Header navigation][Header navigation]]
|
|
- [[Buffer-wide commands][Buffer-wide commands]]
|
|
- [[List editing][List editing]]
|
|
- [[Movement][Movement]]
|
|
- [[Promotion, Demotion][Promotion, Demotion]]
|
|
|
|
* Description
|
|
|
|
This layer adds markdown support to Spacemacs.
|
|
|
|
** Features:
|
|
- markdown files support via [[http://jblevins.org/git/markdown-mode.git/][markdown-mode]]
|
|
- TOC generation via [[https://github.com/ardumont/markdown-toc][markdown-toc]]
|
|
- Completion of Emojis using [[https://github.com/dunn/company-emoji][company-emoji]] (still needs a way of showing, either
|
|
using the =emoji= layer or having a proper font) :clap:
|
|
|
|
* Install
|
|
|
|
To use this contribution add it to your =~/.spacemacs=
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
(setq-default dotspacemacs-configuration-layers '(markdown))
|
|
#+END_SRC
|
|
|
|
* Usage
|
|
|
|
To generate a table of contents type on top of the buffer:
|
|
~SPC : markdown-toc/generate-toc RET~
|
|
|
|
* Key bindings
|
|
|
|
** Element insertion
|
|
|
|
| Key Binding | Description |
|
|
|-------------+-------------------------------------------------------------------|
|
|
| ~SPC m -~ | insert horizontal line |
|
|
| ~SPC m h i~ | insert header dwim |
|
|
| ~SPC m h I~ | insert header setext dwim |
|
|
| ~SPC m h 1~ | insert header atx 1 |
|
|
| ~SPC m h 2~ | insert header atx 2 |
|
|
| ~SPC m h 3~ | insert header atx 3 |
|
|
| ~SPC m h 4~ | insert header atx 4 |
|
|
| ~SPC m h 5~ | insert header atx 5 |
|
|
| ~SPC m h 6~ | insert header atx 6 |
|
|
| ~SPC m h !~ | insert header setext 1 |
|
|
| ~SPC m h @~ | insert header setext 2 |
|
|
| ~SPC m i l~ | insert link |
|
|
| ~SPC m i L~ | insert reference link dwim |
|
|
| ~SPC m i u~ | insert uri |
|
|
| ~SPC m i f~ | insert footnote |
|
|
| ~SPC m i w~ | insert wiki link |
|
|
| ~SPC m i i~ | insert image |
|
|
| ~SPC m i I~ | insert reference image |
|
|
| ~SPC m x b~ | make region bold or insert bold |
|
|
| ~SPC m x i~ | make region italic or insert italic |
|
|
| ~SPC m x c~ | make region code or insert code |
|
|
| ~SPC m x C~ | make region code or insert code (Github Flavored Markdown format) |
|
|
| ~SPC m x q~ | make region blockquote or insert blockquote |
|
|
| ~SPC m x Q~ | blockquote region |
|
|
| ~SPC m x p~ | make region or insert pre |
|
|
| ~SPC m x P~ | pre region |
|
|
|
|
** Element removal
|
|
|
|
| Key Binding | Description |
|
|
|-------------+---------------------|
|
|
| ~SPC m k~ | kill thing at point |
|
|
|
|
** Completion, and Cycling
|
|
|
|
| Key Binding | Description |
|
|
|-------------+-------------|
|
|
| ~SPC m =~ | promote |
|
|
| ~SPC m -~ | demote |
|
|
| ~SPC m ]~ | complete |
|
|
|
|
** Following and Jumping
|
|
|
|
| Key Binding | Description |
|
|
|-------------+-----------------------|
|
|
| ~SPC m o~ | follow thing at point |
|
|
| ~SPC m j~ | jump |
|
|
|
|
** Indentation
|
|
|
|
| Key Binding | Description |
|
|
|-------------+---------------|
|
|
| ~SPC m \>~ | indent region |
|
|
| ~SPC m \<~ | exdent region |
|
|
|
|
** Header navigation
|
|
|
|
| Key Binding | Description |
|
|
|-------------+------------------------------|
|
|
| ~gj~ | outline forward same level |
|
|
| ~gk~ | outline backward same level |
|
|
| ~gh~ | outline up one level |
|
|
| ~gl~ | outline next visible heading |
|
|
|
|
** Buffer-wide commands
|
|
|
|
| Key Binding | Description |
|
|
|-------------+----------------------|
|
|
| ~SPC m c ]~ | complete buffer |
|
|
| ~SPC m c m~ | other window |
|
|
| ~SPC m c p~ | preview |
|
|
| ~SPC m c e~ | export |
|
|
| ~SPC m c v~ | export and preview |
|
|
| ~SPC m c o~ | open |
|
|
| ~SPC m c w~ | kill ring save |
|
|
| ~SPC m c c~ | check refs |
|
|
| ~SPC m c n~ | cleanup list numbers |
|
|
| ~SPC m c r~ | render buffer |
|
|
|
|
** List editing
|
|
|
|
| Key Binding | Description |
|
|
|-------------+------------------|
|
|
| ~SPC m l h~ | promote |
|
|
| ~SPC m l i~ | insert list item |
|
|
| ~SPC m l j~ | move down |
|
|
| ~SPC m l k~ | move up |
|
|
| ~SPC m l l~ | demote |
|
|
|
|
** Movement
|
|
|
|
| Key Binding | Description |
|
|
|-------------+--------------------|
|
|
| ~SPC m {~ | backward paragraph |
|
|
| ~SPC m }~ | forward paragraph |
|
|
| ~SPC m N~ | next link |
|
|
| ~SPC m P~ | previous link |
|
|
|
|
** Promotion, Demotion
|
|
|
|
| Key Binding | Description |
|
|
|-------------+--------------------|
|
|
| ~M-k~ | markdown-move-up |
|
|
| ~M-j~ | markdown-move-down |
|
|
| ~M-h~ | markdown-promote |
|
|
| ~M-l~ | markdown-demote |
|