vim markdown 預覽神器

更多分享內容可訪問我的個人部落格

本文主要介紹 markdown 預覽外掛程式 vim-markdown-composer 以及 markdown-preview.nvim。

vim 沒有內建 markdown 預覽功能，也沒有辦法直接在終端預覽。現有的 vim markdown 預覽外掛程式多是通過瀏覽器等第三方軟體預覽由外掛程式渲染好的 markdown 檔案。

在筆者的體驗中 vim-markdown-composer 以及 markdown-preview.nvim 可以算是其中最好的兩款預覽外掛程式。

參考其github 主頁的安裝配置資訊，很容易搞定。

該外掛程式的優點很明顯。它支援很多內嵌語言的渲染，單檔案渲染體驗極佳。

這裡主要強調一些問題（僅針對本文寫成時存在的問題）。

這裡的多檔案指的是當在多個 buffer 切換的時候，可以自動切換預覽畫面。

如果你無法忍受這些問題，可以使用下乙個外掛程式。

該外掛程式需要 rust 語言環境支援。關於如何配置 rust 環境，由於步驟非常簡單，提倡自行解決。

參考其github 主頁的配置，使用 vim-plug 的使用者可以使用以下配置安裝。

function! buildcomposer(info)
if a:info.status != 'unchanged' || a:info.force
if has('nvim')
!cargo build --release --locked
else
!cargo build --release --locked --no-default-features --features json-rpc
endif
endif
endfunction
plug 'euclio/vim-markdown-composer',

安裝後使用:help markdown-composer可以檢視其文件。主要有幾個配置引數，以及外掛程式命令。這裡給出外掛程式提供的命令。

:composerstart start the preview server. :composerupdate send the current buffer to the preview server. :composeropen opens a new browser window containing the markdown preview.

:composerjob echoes the channel that the plugin is listening on.

可以自行配置快捷鍵。這裡給出我的配置。

" markdown-composer
let g:markdown_composer_external_renderer='pandoc -f markdown -t html'
let g:markdown_composer_autostart = 0
nmap ms :composerstartnmap mu :composerupdatenmap mo :composeropennmap mj :composerjoblet g:which_key_map2.m =

該外掛程式多檔案切換預覽效果非常好。但是注意，該外掛程式本身沒有內建 latex 語言的渲染功能，其他語言就更不用說了。所以要想或者最佳體驗，還需要使用外部渲染器。即上面給出配置中的第一行，使用 pandoc 渲染 markdown 檔案。因此還必須安裝 pandoc 軟體，並確定可以在全域性呼叫 pandoc 命令。

另有乙個注意事項。假設有目錄 x，內有二級目錄 a 和 b。a 中存放 markdown 檔案，b 中存放。如果在 a 目錄內開啟 markdown 檔案，則還是會出現上乙個外掛程式新無法載入的問題（如果呼叫時使用絕對路徑可能不會出現該問題）。如果在 x 目錄下開啟 a 中的 markdown 檔案，則不會有上述問題。其他位置開啟，應該都有該問題。

vim markdown 預覽神器

Vim Markdown 結合使用

vim markdown外掛程式不能正常工作問題排查

PDF預覽 pdfJS預覽pdf檔案

vim markdown 預覽神器

Vim Markdown 結合使用

vim markdown外掛程式不能正常工作問題排查

PDF預覽 pdfJS預覽pdf檔案

相關推薦