Markdown Instant Preview aka mip is a fast and bloatless markdown document
viewer. Mip uses a webview window to render the markdown. I wrote mip to
preview my markdown files which I write in vim.
After a first attempt of developing Mip in Crystal, Rust seemed a better choice as it has more mature parallism support. This is essential for running webview next to a webserver.
See the simple workflow in this video...
mip-video.webm
- built-in webserver
- preview images
- hides frontmatter
- autoreload if file changes
- uft8 & 🤔 support
The latest Mip binaries for Mac and Windows can be downloaded at the release pages. Currently we have problems building Linux binaries with our workflow. Help with this would be appreciated.
mip [markdown file]
- prj: Readme best practices
- app: command line options
- app: improve error handling
- app: use webview reload and not javascript reload
- prj: refactor cleanup var names
- prj: testing
- prj: release workflow
- auto build binaries at release
- version tag script
- set version and date in changelog
- app: table of contents
- app: reload keybinding
- app: rm temp files
- app: vim keybindings
- app: export pdf
- app: export html
- blog: mip.cr and mip.rs
- prog: nix build
- app: linux desktop info
- Under wayland you might need to set `WEBKIT_DISABLE_DMABUF_RENDERER=1
nix develop
make
## Development
### Prerequisites
- webkitgtk
- rust
- yarn (if you want modify the html template)
### Setup HTML Template dev Environment
```bash
yarn
cargo runcargo build --releasemake compthemes
./mip- Fork it (https://github.com/mipmip/mip.rs/fork)
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request
- Pim Snel - creator and maintainer