markplus_render 0.1.0

HTML and PDF renderer for the MarkPlus ecosystem (AST → HTML / Typst → PDF)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

# markplus_render


HTML and PDF renderer for the [MarkPlus](https://github.com/PurnenduK90/markplus-core) ecosystem.

Consumes a `SiteAsset` (schema + frontmatter + AST) produced by `markplus_core` and emits:

| Target | How |
|---|---|
| **HTML** | AST → Tera `*.html.tera` template → `.html` string |
| **Typst source** | AST → Tera `*.typ.tera` template → `.typ` string |
| **PDF (native)** | Typst source → `typst-as-lib` → PDF bytes |
| **PDF (wasm)** | Typst source → embedded `WasmWorld` → PDF bytes (`--features wasm`, ~30 MB) |

## Quick start


```rust
use markplus_core::parse_document;
use markplus_render::RenderEngine;

let asset = parse_document("# Hello\n\n**World.**")?;
let engine = RenderEngine::builder().build()?; // loads templates/ dir

let html      = engine.render_html(&asset, "default/article.html.tera")?;
let typst_src = engine.render_typst_string(&asset, "default/article.typ.tera")?;
let pdf_bytes = engine.compile_pdf(&typst_src)?;
```

## Feature flags


| Feature | Default | Description |
|---|---|---|
| _(none)_ | ✓ | Native HTML + Typst + PDF |
| `wasm` | off | Adds `wasm-bindgen` exports + in-browser PDF via embedded fonts |

## Template directory


Default templates live in `templates/default/`:

```
templates/
└── default/
    ├── article.html.tera   ← HTML article
    └── article.typ.tera    ← Typst article (→ PDF)
```

Override at runtime:

```rust
let engine = RenderEngine::builder()
    .with_templates(Path::new("/my/custom/templates"))
    .build()?;
```

## PDF pipeline


```
Markdown → markplus_core → SiteAsset
                               │
                    render_typst_string()
                               │
                           .typ source
                               │
                 ┌─────────────┴─────────────┐
                 │ native                    │ wasm
          typst-as-lib                  WasmWorld
          + system fonts           + Liberation fonts
                 │                           │
                 └──────────── PDF bytes ────┘
```

## Example


```sh
cargo run --example render_doc -- my_note.md
# Writes my_note.html, my_note.typ, my_note.pdf

```

## License


Apache-2.0