Back to Spacevim

SpaceVim lang#markdown layer

docs/layers/lang/markdown.md

2.4.03.4 KB
Original Source

Available Layers >> lang#markdown

<!-- vim-markdown-toc GFM --> <!-- vim-markdown-toc -->

Description

This layer is for editing markdown file.

Install

To use this configuration layer, update your custom configuration file with:

toml
[[layers]]
  name = "lang#markdown"

The tagbar support is provided via lvht/tagbar-markdown which requires php to be installed. You can also use mdctags which is written in rust.

Formatting

SpaceVim uses remark to format Markdown file by default. You can install remark via npm, the commands are shown below.

sh
npm -g install remark
npm -g install remark-cli
npm -g install remark-stringify
npm -g install remark-frontmatter
npm -g install wcwidth

To use Prettier, you need to change the layer option: enabled_formatters.

You can install Prettier via yarn or npm, the commands are shown below:

  1. Via yarn
sh
yarn global add prettier
  1. Via npm
sh
npm install --global prettier

options

listItemIndent

How to indent the content from list items (tab, mixed or 1 , default: 1).

  • 'tab': use tab stops (4 spaces)
  • '1': use one space
  • 'mixed': use 1 for tight and tab for loose list items

enableWcwidth

Enable/Disable wcwidth for detecting the length of a table cell, default is 0. To enable this option, you need to install wcwidth

listItemChar

Bullet marker to use for list items ('-', '*', or '+', default: '-').

enabled_formatters

Specify the enabled formater for markdown file, default is ['remark']. You can also append multiple formatters to this list. e.g. ["remark", "prettier"].

Tagbar

To have a table of the headings in the tagbar (toggled by [F2]), make sure php is in your $PATH (you can test this in SpaceVim : :!php --version should print something about php).

If you don't want to install php, you can use mdctags as an alternative.

Key bindings

Key bindingsmodeDescriptions
SPC b fNormalFormat current buffer
SPC l cNormal/VisualCreate content at cursor
SPC l CNormal/VisualRemove content
SPC l kNormal/VisualAdd URL link for word under cursor or slected word
SPC l KNormal/VisualAdd picture link for word under cursor or slected word
SPC l rNormal/VisualRun code block
SPC l fNormal/VisualFormat code block
SPC l uNormal/VisualUpdate content
SPC l pNormalReal-time markdown preview
SPC l tNormaltoggle todo status