insight
insight
is a web server allowing you to edit markdown posts and host the rendered result publicly.
It has less than 40 dependencies in total.
Setup
- Install the Rust toolchain
- Get insight:
$ cargo install insight
- Start the server:
$ insight -l 0.0.0.0:9090
This will accept requests from all IP addresses
- Access the server from a web browser to generate the home page: http://localhost:9090/
- Edit your home page
- Save the home page edition link (which is secret) to be able to edit it again later
- Go to http://localhost:9090/new to create other posts.
Security considerations
The fact that secret edition keys are parts of the URL is bad. If you see any alternative that doesn't require user accounts or entering a password, please file an issue on GitHub.
HTML tags are currently stripped from posts at render-time to prevent cross-site scripting vulnerabilities. We rely on the pulldown_cmark
crate to detect these tags. If you manage to get any JS code to execute in the post viewer via markdown, please file an issue because it shouldn't happen.