I’m looking to set up a literate programming environment in Visual Studio Code (VS Code) using Python and Markdown. My goal is to have a mixed Python and Markdown document on the left side and a rendered view on the right side, where I can see outputs like plots fully rendered in real-time.
Here are some details and constraints:
- I checked out Literate, but it doesn’t have a lot of users, and the syntax seems a bit peculiar, so I’m not sure how it actually works.
- Entangled seems brilliant, but it appears to be only for the Vim editor.
- I don’t want to use
.ipynb
files because they are not git-friendly. - I’m open to using other flavors of Markdown or other lightweight markup languages such as AsciiDoc, reStructuredText (ReST/RST), Markedly Structured Text (MyST), Typst, Quarto, etc., as long as they support almost instant rendering (real-time). For example, the TeX family of things (e.g., LaTeX, ConTeX, LuaTeX) are not a good answer for me (more on that here).
Does anyone have a solution or workflow that fits these requirements? Any extensions, tools, or configurations that can help achieve this in VS Code would be greatly appreciated!