markdown-preview-enhanced with litvis
This project is a fork of
vscode-markdown-preview-enhanced, which is a popular VSCode extension for previewing markdown files.
Most of the code in this fork is inherited from the upstream repository and is thus courtesy of @shd101wyy and other contributors to
The fork produces a VSCode extension called
markdown-preview-enhanced-with-litvis, which enables Literate Visualisation (litvis) in rendered markdown previews.
Litvis functionality has been designed and developed at giCentre by Jo Wood, Alexander Kachkaev and Jason Dykes.
This research was in part supported by the EU under the EC Grant Agreement No. FP7-IP-608142 to Project VALCRI.
Please ensure that you have a reasonably recent version of Node.js installed on your machine before proceeding to the setup.
It can be downloaded and installed from https://nodejs.org/.
Setup for VSCode users
Via VSCode’s GUI
Click on the extensions icon in the left panel, search for Markdown Preview Enhanced with litvis and click install.
If you are using Markdown Preview Enhanced extension (from which this project was forked), temporary uninstall or disable it while you are trying out litvis.
Via command line
code --install-extension gicentre.markdown-preview-enhanced-with-litvis
code --uninstall-extension shd101wyy.markdown-preview-enhanced
VSCode does not support
--disable-extension command, so if you want disable
shd101wyy.markdown-preview-enhanced instead of uninstalling it, please do this via the app’s GUI.
Getting started with litvis narratives
Literate visualization uses Elm and Vega-Lite in the form of a declarative visualization language elm-vega.
While you don't have to use elm-vega in a litvis document it does enable quick declarative generation of interactive data graphics and therefore considerably enhances the capability of a litvis document.
Creating your own litvis narrative is as easy as writing a markdown file.
You can start with exploring the examples available at