6 releases
new 0.2.1 | Jan 3, 2025 |
---|---|
0.2.0 | Dec 30, 2024 |
0.1.3 | Sep 1, 2024 |
0.1.2 | Aug 22, 2024 |
#158 in GUI
102 downloads per month
1MB
4.5K
SLoC
🌋 Igneous-md
The simple and lightweight markdown framework / viewer written in rust
Igneous-md is a gfm compatible markdown viewer and viewer framework with a focus of staying lightweight and extensible
Features
- Syntax highlighting similar to GitHub using highlight.js
- Standalone markdown viewer outside browser
- Switching of stylesheets on the fly
- Ability to add custom CSS
- Export generated HTML
- Works offline
To-do
-
Fix bugs
-
Create packages
-
Write tests
-
Add optional support for markdown highlight notes
-
Make the viewer be able to re-attach to the server
-
Introduce proper hot-reloading for the config
-
Optimize performance
Usage
igneous-md path/to/file.md
For more information see docs.md
A markdown viewer Framework?
Yes. It's simpler than it sounds.
Since igneous-md works by using a server in the background and then communicates with the built-in viewer, as well as the browser, using https and websockets anyone could use this to write their own viewer.
The benefits of this being you would receive all of the hot-reloading and conversion from md to html for free, while having full freedom to implement their viewer however they would like.
The only real limitation on this is what the websocket json-protocol is written to support. (PRs welcome)
This aspect of igneous-md is still WIP, but if you already want to get started check out ./crates/igneous-md/src/handlers/ws.rs
and have a look at is possible right now.
If you want to only use igneous-md for this be sure to disable the viewer
cargo feature.
Attribution
Many thanks to all the people, who have created/contributed to technology used in the creation this project.
License
This project is licensed under either of
at your option.
Dependencies
~24–61MB
~1M SLoC