Skip to content

markmap/coc-markmap

Repository files navigation

coc-markmap

NPM

Visualize your Markdown as mindmaps with markmap.

This is an extension for coc.nvim.

If you prefer a CLI version, see markmap-cli.

Note: coc-markmap allows generating markmaps from current buffer or selected text, while the CLI version can only create markmaps from Markdown files.

markdown mindmap

Installation

First, make sure coc.nvim is started.

Then install with the Vim command:

:CocInstall coc-markmap

Usage

You can run the commands below in a buffer of Markdown file.

Generating a markmap HTML

:CocCommand markmap.create

Or inline all assets to work offline:

:CocCommand markmap.create --offline

This command will create an HTML file rendering the markmap and can be easily shared.

The HTML file will have the same basename as the Markdown file and will be opened in your default browser. If there is a selection, it will be used instead of the file content.

Transforming plugins are enabled by default, including syntax highlight with PrismJS and math typesetting with Katex.

Watching mode

:CocCommand markmap.watch

This command will start a development server and track your cursor.

The markmap will update once the markdown file changes, and the node under cursor will always be visible in the viewport on cursor move.

Configurations

CocConfig

You can change some global configurations for this extension in coc-settings.json.

First open the settings file with :CocConfig.

Key mappings

There is no default key mapping, but you can easily add your own:

" Create markmap from the whole file
nmap <Leader>m <Plug>(coc-markmap-create)
" Create markmap from the selected lines
vmap <Leader>m <Plug>(coc-markmap-create-v)

Commands

It is also possible to add a command to create markmaps.

command! -range=% Markmap CocCommand markmap.create <line1> <line2>

Now you have the :Markmap command to create a Markmap, either from the whole file or selected lines.