---

Ⅰ. 插件描述

Markdown preview for neovim using pandoc and live-server

Ⅱ. 基本信息

创建日期：  2018-05-09 使用用户：  1 Github星：  1 插件作者：  David Granström

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'davidgranstrom/nvim-markdown-preview'

… 然后在Vim中运行以下命令:

:source %
:PluginInstall

对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'davidgranstrom/nvim-markdown-preview'

… 然后在Vim中运行以下命令:

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'davidgranstrom/nvim-markdown-preview'

… 然后在Vim中运行以下命令:

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/davidgranstrom/nvim-markdown-preview

Ⅳ. 文档说明

# nvim-markdown-preview

Markdown preview in the browser using pandoc and live-server through Neovim's job-control API.

Usage

Open a markdown file in vim and run :MarkdownPreview. The preview opens in a new browser tab which will be reloaded whenever you :write the buffer. If you accidentally close your browser tab or want to change the theme just run the command again. The file needs to be written to disk before you can start the preview.

Features

• Asynchronous
• Produces "standalone" html files (injected css)
• Custom themes (github, solarized-dark, solarized-light)
• Auto-reloads browser tab on save
• Serves assets from the current working directory (embed pictures in your markdown etc.)

Requirements

• pandoc
• live-server (Node.js)

pandoc and live-server executables should be installed and accessible in your $PATH. Please see the links in the description on how to install these programs on your system.

On macOS it could look something like:

$ brew install pandoc
$ npm install -g live-server

(or if you prefer yarn)

$ yarn global add live-server

Installation

If you are using vim-plug

Plug 'davidgranstrom/nvim-markdown-preview'

source the file (or restart vim) and then run :PlugInstall

Documentation

Take a look at :help nvim-markdown-preview for documentation and examples.

Screenshots

Q/A

Q: Why doesn't the preview update in real-time while I type in vim?

A: This plugin simply doesn't work like that. It is aimed to be "lightweigth" (if you already are a node.js/pandoc user that is).
It simply provides some live update capabilities around what is essentially :w !pandoc % -o /tmp/file.html

Q: I want the preview tab to open automatically without typing :MarkdownPreview

A: Sure, use an autocmd like:

autocmd FileType markdown MarkdownPreview

Or the <Plug> mapping to bind it to the key of your choice

nmap <cr> <plug>(nvim-markdown-preview)

TODO

The markdown file must be written to disk first. It should be possible to use Pandoc stdin and pipe the buffer content using jobsend() instead.

License

nvim-markdown-preview
Copyright (C) 2018 David Granström

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.