https://github.com/testingrequired/mdbook-pagebreaks
A mdbook preprocessor that inserts print page breaks in HTML
https://github.com/testingrequired/mdbook-pagebreaks
html markdown mdbook mdbook-preprocessor
Last synced: 6 months ago
JSON representation
A mdbook preprocessor that inserts print page breaks in HTML
- Host: GitHub
- URL: https://github.com/testingrequired/mdbook-pagebreaks
- Owner: testingrequired
- License: mit
- Created: 2024-11-02T08:06:19.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-03T02:41:29.000Z (over 1 year ago)
- Last Synced: 2025-07-19T16:41:48.822Z (7 months ago)
- Topics: html, markdown, mdbook, mdbook-preprocessor
- Language: Rust
- Homepage:
- Size: 11.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# mdbooks-pagebreaks
A mdbook preprocessor that replaces `{{---}}` with explicit print page breaks in HTML.
https://crates.io/crates/mdbook-pagebreaks
## Example
The sections `Title`, `Section 1`, `Section 2`, and `Section 3` will all be printed on seperate pages.
```markdown
# Title
Donec condimentum eros ante, eu mollis orci suscipit sit amet. Morbi semper mi turpis, eu scelerisque nibh scelerisque id.
{{---}}
## Section 1
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed leo elit, interdum nec ante non, malesuada fringilla ligula. Vestibulum bibendum lobortis sapien, nec sodales metus porttitor quis. Vivamus fringilla luctus tincidunt. Pellentesque viverra sagittis euismod.
{{---}}
## Section 2
Proin tortor risus, viverra et tortor viverra, pretium luctus lorem. Nulla facilisi. Etiam vel ipsum quis eros sollicitudin accumsan at eu ipsum. Maecenas sed maximus urna. Phasellus eget neque vel nisl finibus scelerisque sit amet eu nunc.
{{---}}
## Section 3
Quisque nec dapibus nisi. Aliquam vehicula consequat libero eu dapibus. Curabitur nec diam suscipit, fringilla ligula et, suscipit ipsum. Sed sodales eros quis maximus faucibus. Integer sit amet pulvinar nulla.
```
## Install
```shell
cargo install mdbook-pagebreaks --version 0.3.1
```
## Initialize
```shell
cd path/to/book
mdbook-pagebreaks init
```
## Configure
```toml
[preprocessor.pagebreaks]
[output.html]
additional-css = ["mdbook-pagebreaks.css"]
```