Skip to main content

a simple markdown viewer for linux

Project description


a simple markdown viewer for linux.



  • python3 pointing to Python 3.6+.
  • Pandoc [pip3 install pandoc | apt install pandoc | pacman -S pandoc | ... ]
  • Flask [pip3 install flask | apt install python3-flask | pacman -S python-flask | ... ]


  • Neovim Remote [pip3 install neovim neovim-remote]
  • Jupyter (to view jupyter notebooks) [pip3 install jupyter | apt install jupyter | pacman -S jupyter | ... ]


    pip3 install smdv

Neovim compatibility

This viewer was made with neovim compatibility in mind. With the use of neovim-remote, this script is able to open files in the current neovim window (or spawn a new neovim window if there is no window available).

However, to make it fully compatible with neovim and to make neovim able to sync its current file to the viewer, neovim-remote should be installed and the following lines should be added to your init.vim:

    " start smdv with <F5> from inside neovim using the current neovim server to sync to
    autocmd FileType markdown nnoremap <F5> :w<CR>:silent execute '!killall smdv; smdv %% -v "'.v:servername'" &> /dev/null & disown'<CR>

    " sync the current markdown file to smdv on save.
    autocmd BufWritePost *.md silent !smdv --sync %%<CR>

This (re)starts the viewer when pressing <F5> and will sync the state after every save.


markdown preview




Project details

Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
smdv-0.0.0-py3-none-any.whl (7.9 kB) Copy SHA256 hash SHA256 Wheel py3
smdv-0.0.0.tar.gz (7.4 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page