🌋 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

• Apache License, Version 2.0
• MIT License

at your option.