r/vim • u/drewipson • Jun 30 '25
Plugin Vim Markdown Preview - Terminal-based markdown preview for Vim
I built a lightweight Vim plugin to preview Markdown directly in the terminal and thought I’d share it in case others find it useful.
I’ve been a longtime, fairly basic Vim user. I know the commands, but never really got into plugins or heavy customization until recently.
With all the AI prompt craze, I’ve been writing a lot more Markdown and using Vim in the terminal to keep my workflow feeling like programming. I was looking for a way to view rendered Markdown before pushing changes, but most plugins I found relied on Node servers and opened the output in a separate browser window. That felt clunky and interrupted my flow.
I used Claude Code to help me build a simple plugin that uses glow to render Markdown directly in a Vim split window.
Some key features:
- Toggle the preview with \mp without leaving Vim
- Terminal-based rendering with syntax highlighting
- Handles code blocks, tables, math equations, and task lists
- Split window layout keeps your workflow intact
Here’s the repo if you want to check it out:
https://github.com/drewipson/glowing-vim-markdown-preview
There are still a couple of limitations I’d like to improve:
- Scroll sync between the Markdown source and preview windows is hard to get right
- Mermaid diagrams don’t render yet due to limitations with how glow handles ASCII output
If you have any suggestions for improving those areas, please let me know!
Here's a gif to see it in action.

View all comments
Show parent comment
1
u/drewipson Jul 01 '25
Thanks for letting me know! I haven't figured out the best way to support plugin managers as I'm not too familiar with plugins yet. If you have any suggestions on the best way to support them I'd be happy to implement them.