Runme for Visual Studio Code
This VS Code extension transparently opens markdown files (i.e. README.md) as runnable VS Code notebooks (with the click of a
Please visit Runme's documentation to learn about its purpose, all its features, and how to get the most out of it:
This project is open source licensed under APL2.0 and its code can be found in the following repos:
Feel free to submit any issues you may have via the issue tracker or tell us about it on Discord.
After cloning into a repo in VS Code, open any markdown file and notice that instead of opening the markdown file content, in renders a notebook where shell commands are rendered as runnable blocks. Please see Runme's Getting Started guide for step-by-step instructions.
Configure Cell Execution
Runme allows code blocks to be annotated with attributes to provide control over some aspects of execution, output, interaction, and other behavior. Please find a complete list in the docs.
For instance, the following annotation will run the command in the background, great for compilers/bundler with file watchers. To enable or disable any of the available options just click the respective cell's
Check the complete list of configuration options at https://runme.dev/docs/configuration or take a look at the examples which are also illustrated in Runme's integration docs.
How It Works
Runme currently consists of a Markdown server (written in Go) which is connected to VS Code extension (via GRPC; optionally WebAssembly being deprecated) and the runme CLI (Go binary) allowing for a consistent experience. The Runme VS Code extension leverages the notebook APIs to transparently provide an interactive user experience on top of static markdown files, such as README.md.
Runme is in rapid development. Checkout our roadmap at https://github.com/stateful/runme/projects. Please be aware of following known limitations:
We would love to hear feedback, appreciate your patience, as Runme continutes to harden. Get in touch please!