Add README.md

This commit is contained in:
2026-03-18 21:32:53 +08:00
parent 8ed58fe9de
commit f9834b6756

76
README.md Normal file
View 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