| Markdown to Vento Converter

Front Matter Handling: Front matter, marked by --- , is included in the output without modification.
Code Block Handling: Code blocks are detected by ``` delimiters. Code blocks are wrapped in &lt;pre&gt;&lt;code&gt; tags, preserving their content.
HTML Tag Detection: HTML content is left unchanged and not wrapped in additional tags.
Text Wrapping: Non-code, non-HTML, non-front matter text is wrapped in &lt;p&gt; tags.

Why?

This tool was born from recent work on our housing site where we started documenting some of our code using jupyter notebooks. In summary:

If you have a jupyter notebook and you want include the result on a Lume site, you need to convert it to a format Lume knows about.
You can automatically convert notebooks to markdown with jupyter nbconvert.
However, if you then want to include other elements like OI Lume charts or parts of other pages using {{ includes }} tags, you need a .vento (or .njk) file.
This tool converts the markdown format to vento, preserving things like front matter, and various HTML tags. It adds <p> tags to sentences and formats any code blocks correctly so that they can be styled using the prism plugin.

How to use:

First, convert your notebook using the command line: jupyter nbconvert your_notebok.ipynb --to markdown. The output will be saved in your current working directory. Then use this tool to convert the markdown to vento.

Drop a markdown file here

Download Converted File

This programme runs in the browser - nothing ever leaves your computer.