Add README.md
This commit is contained in:
76
README.md
Normal file
76
README.md
Normal file
@@ -0,0 +1,76 @@
|
|||||||
|
# md_reader
|
||||||
|
|
||||||
|
A simple Markdown reader with Mermaid diagram support.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
- Render Markdown to HTML
|
||||||
|
- Batch convert Markdown files
|
||||||
|
- HTTP server for serving files
|
||||||
|
- **Mermaid diagram support** with SVG export
|
||||||
|
- Preview in browser
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo build --release
|
||||||
|
```
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
### Render a single file
|
||||||
|
|
||||||
|
```bash
|
||||||
|
md_reader render document.md -o output.html
|
||||||
|
```
|
||||||
|
|
||||||
|
### Batch convert
|
||||||
|
|
||||||
|
```bash
|
||||||
|
md_reader batch ./docs/ -o ./html/
|
||||||
|
```
|
||||||
|
|
||||||
|
### Start HTTP server
|
||||||
|
|
||||||
|
```bash
|
||||||
|
md_reader server -p 8080 -d ./docs/
|
||||||
|
```
|
||||||
|
|
||||||
|
### Preview in browser
|
||||||
|
|
||||||
|
```bash
|
||||||
|
md_reader preview document.md
|
||||||
|
```
|
||||||
|
|
||||||
|
## Mermaid Support
|
||||||
|
|
||||||
|
md_reader supports rendering Mermaid diagrams in Markdown files.
|
||||||
|
|
||||||
|
### Usage
|
||||||
|
|
||||||
|
Use `mermaid` code blocks:
|
||||||
|
|
||||||
|
````markdown
|
||||||
|
```mermaid
|
||||||
|
graph TD
|
||||||
|
A[Start] --> B[End]
|
||||||
|
```
|
||||||
|
````
|
||||||
|
|
||||||
|
### Supported Diagram Types
|
||||||
|
|
||||||
|
- Flowchart
|
||||||
|
- Sequence Diagram
|
||||||
|
- Class Diagram
|
||||||
|
- State Diagram
|
||||||
|
- Gantt Chart
|
||||||
|
- Pie Chart
|
||||||
|
- Entity Relationship Diagram
|
||||||
|
|
||||||
|
### SVG Export
|
||||||
|
|
||||||
|
Hover over any Mermaid diagram and click "Download SVG" to download the vector graphic.
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
MIT
|
||||||
Reference in New Issue
Block a user