]>
git.madduck.net Git - etc/vim.git/blobdiff - README.md
madduck's git repository
Every one of the projects in this repository is available at the canonical
URL git://git.madduck.net/madduck/pub/<projectpath> — see
each project's metadata for the exact URL.
All patches and comments are welcome. Please squash your changes to logical
commits before using git-format-patch and git-send-email to
patches@ git. madduck. net .
If you'd read over the Git project's submission guidelines and adhered to them,
I'd be especially grateful.
SSH access, as well as push access can be individually
arranged .
If you use my repositories frequently, consider adding the following
snippet to ~/.gitconfig and using the third clone URL listed for each
project:
[url "git://git.madduck.net/madduck/"]
insteadOf = madduck:
Add the following line to your `.vimrc` to disable the folding configuration:
```vim
Add the following line to your `.vimrc` to disable the folding configuration:
```vim
-let g:vim_markdown_folding_disabled= 1
+let g:vim_markdown_folding_disabled = 1
```
This option only controls Vim Markdown specific folding configuration.
```
This option only controls Vim Markdown specific folding configuration.
the following to your `.vimrc`:
```vim
the following to your `.vimrc`:
```vim
-let g:vim_markdown_folding_style_pythonic=1
+let g:vim_markdown_folding_style_pythonic = 1
+```
+
+### Set header folding level
+
+Folding level is a number between 1 and 6. By default, if not specified, it is set to 1.
+
+```vim
+let g:vim_markdown_folding_level = 6
+```
+
+Tip: it can be changed on the fly with:
+
+```vim
+:let g:vim_markdown_folding_level = 1
+:edit
```
### Disable Default Key Mappings
```
### Disable Default Key Mappings
Add the following line to your `.vimrc` to disable default key mappings:
```vim
Add the following line to your `.vimrc` to disable default key mappings:
```vim
-let g:vim_markdown_no_default_key_mappings= 1
+let g:vim_markdown_no_default_key_mappings = 1
```
You can also map them by yourself with `<Plug>` mappings.
```
You can also map them by yourself with `<Plug>` mappings.
+### Enable TOC window auto-fit
+
+Allow for the TOC window to auto-fit when it's possible for it to shrink.
+It never increases its default size (half screen), it only shrinks.
+
+```vim
+let g:vim_markdown_toc_autofit = 1
+```
+
### Syntax extensions
The following options control which syntax extensions will be turned on. They are off by default.
### Syntax extensions
The following options control which syntax extensions will be turned on. They are off by default.
Used as `$x^2$`, `$$x^2$$`, escapable as `\$x\$` and `\$\$x\$\$`.
```vim
Used as `$x^2$`, `$$x^2$$`, escapable as `\$x\$` and `\$\$x\$\$`.
```vim
-let g:vim_markdown_math= 1
+let g:vim_markdown_math = 1
```
#### YAML frontmatter
```
#### YAML frontmatter
Highlight YAML frontmatter as used by Jekyll:
```vim
Highlight YAML frontmatter as used by Jekyll:
```vim
-let g:vim_markdown_frontmatter= 1
+let g:vim_markdown_frontmatter = 1
## Mappings
The following work on normal and visual modes:
## Mappings
The following work on normal and visual modes:
+The following requires `:filetype plugin on`.
+
- `:HeaderDecrease`:
Decrease level of all headers in buffer: `h2` to `h1`, `h3` to `h2`, etc.
- `:HeaderDecrease`:
Decrease level of all headers in buffer: `h2` to `h1`, `h3` to `h2`, etc.
If a range is given, e.g. hit `:` from visual mode, only operate on the range.
If a range is given, e.g. hit `:` from visual mode, only operate on the range.
-- `:TableFormat`: Format the table under the cursor [like this](http://www.cirosantilli.com/markdown-styleguide/#tables).
+- `:TableFormat`: Format the table under the cursor [like this](http://www.cirosantilli.com/markdown-style- guide/#tables).
Requires [Tabular](https://github.com/godlygeek/tabular).
Requires [Tabular](https://github.com/godlygeek/tabular).
projects / etc / vim.git / blobdiff