me, as I type "cargo new --bin mdbook-handlebars"
i think i'm going with feeling better :D
i think i'm going with feeling better :D
February 9, 2025 at 3:22 AM
me, as I type "cargo new --bin mdbook-handlebars"
i think i'm going with feeling better :D
i think i'm going with feeling better :D
fallen to the "write an mdbook" temptation
March 21, 2026 at 2:49 AM
fallen to the "write an mdbook" temptation
Check out this book I'm writing about compilers and the process of compiling @gleam.run to wasm!
Writing compilers is hard!!
Writing compilers is hard!!
June 10, 2026 at 10:39 PM
Check out this book I'm writing about compilers and the process of compiling @gleam.run to wasm!
Writing compilers is hard!!
Writing compilers is hard!!
✨ Create your own book with mdbook easily
- Command line tool to create books with Markdown
- Ideal for creating product or API documentation, tutorials, course materials or anything that requires a clean, easily navigable and customizable presentation
rust-lang.github.io/mdBook/
#programming
- Command line tool to create books with Markdown
- Ideal for creating product or API documentation, tutorials, course materials or anything that requires a clean, easily navigable and customizable presentation
rust-lang.github.io/mdBook/
#programming
February 22, 2025 at 1:58 AM
✨ Create your own book with mdbook easily
- Command line tool to create books with Markdown
- Ideal for creating product or API documentation, tutorials, course materials or anything that requires a clean, easily navigable and customizable presentation
rust-lang.github.io/mdBook/
#programming
- Command line tool to create books with Markdown
- Ideal for creating product or API documentation, tutorials, course materials or anything that requires a clean, easily navigable and customizable presentation
rust-lang.github.io/mdBook/
#programming
every time a custom website is replaced with an mdbook my soul shrivels up and dies a little
June 29, 2025 at 1:14 PM
every time a custom website is replaced with an mdbook my soul shrivels up and dies a little
I like to call myself the "chief compliance officer" because that's basically my job. I handle most of the administrative stuff like balancing the books, doing the corporate return, etc. I wrote a 11k word mdbook about all those operational aspects so our bus number can be slightly greater than 1
September 25, 2026 at 4:52 AM
I like to call myself the "chief compliance officer" because that's basically my job. I handle most of the administrative stuff like balancing the books, doing the corporate return, etc. I wrote a 11k word mdbook about all those operational aspects so our bus number can be slightly greater than 1
⚡ Run Rust Run ⚡
December 17, 2024 at 10:18 AM
⚡ Run Rust Run ⚡
It took me 12 attempts, but I managed to deploy an mdbook to GitHub pages. I'm a professional!
May 18, 2026 at 9:08 AM
It took me 12 attempts, but I managed to deploy an mdbook to GitHub pages. I'm a professional!
Small improvement on mdbook CLI: it now displays where the HTML was generated.
PR: github.com/rust-lang/md...
PR: github.com/rust-lang/md...
Show where the book was generated by GuillaumeGomez · Pull Request #2729 · rust-lang/mdBook
It now looks like this:
$ cargo run -- build test_book/
Compiling mdbook v0.4.51 (/somewhere/mdBook)
Finished `dev` profile [unoptimized + debuginfo] target(s) in 4.48s
Running `target/...
github.com
July 16, 2025 at 9:55 AM
Small improvement on mdbook CLI: it now displays where the HTML was generated.
PR: github.com/rust-lang/md...
PR: github.com/rust-lang/md...
🦀 Pico Pico - Embedded Programming with Rust
- mdbook, a collection of small projects(more to add) and tutorials on Pico 2 using Rust
pico.implrust.com
#embedded #rustlang
- mdbook, a collection of small projects(more to add) and tutorials on Pico 2 using Rust
pico.implrust.com
#embedded #rustlang
October 30, 2024 at 1:52 AM
🦀 Pico Pico - Embedded Programming with Rust
- mdbook, a collection of small projects(more to add) and tutorials on Pico 2 using Rust
pico.implrust.com
#embedded #rustlang
- mdbook, a collection of small projects(more to add) and tutorials on Pico 2 using Rust
pico.implrust.com
#embedded #rustlang
It would be neat if Rust proc-macros could generate like, sidecar data that could be used in other parts of a build or something.
I'm thinking like for doing documentation like with `clap`'s derived, if it could also generate something that could be consumed by an `mdbook` pre-processor.
I'm thinking like for doing documentation like with `clap`'s derived, if it could also generate something that could be consumed by an `mdbook` pre-processor.
September 23, 2026 at 4:40 AM
It would be neat if Rust proc-macros could generate like, sidecar data that could be used in other parts of a build or something.
I'm thinking like for doing documentation like with `clap`'s derived, if it could also generate something that could be consumed by an `mdbook` pre-processor.
I'm thinking like for doing documentation like with `clap`'s derived, if it could also generate something that could be consumed by an `mdbook` pre-processor.
Thanks all for your answers. I tried vitepress but it didn't add chapters automatically.
Gone with mdbook from the rust ecosystem.
rust-lang.github.io/mdBook/
I have to get the extract in the right shape and the summary and searching is 'free'
Gone with mdbook from the rust ecosystem.
rust-lang.github.io/mdBook/
I have to get the extract in the right shape and the summary and searching is 'free'
November 30, 2025 at 10:24 PM
Thanks all for your answers. I tried vitepress but it didn't add chapters automatically.
Gone with mdbook from the rust ecosystem.
rust-lang.github.io/mdBook/
I have to get the extract in the right shape and the summary and searching is 'free'
Gone with mdbook from the rust ecosystem.
rust-lang.github.io/mdBook/
I have to get the extract in the right shape and the summary and searching is 'free'
If proc macros could generate sidecar data, then the mdbook processor would just need to search the crate build directory for the serialized command documentation and then use that,
No need to link the full-fat application with the processor.
No need to link the full-fat application with the processor.
September 23, 2026 at 4:48 AM
If proc macros could generate sidecar data, then the mdbook processor would just need to search the crate build directory for the serialized command documentation and then use that,
No need to link the full-fat application with the processor.
No need to link the full-fat application with the processor.
You can say zig or c++ should have borrow checking but how? The closest thing to a spec is a partially complete set of datalog predicates in the polonius mdbook
July 20, 2026 at 4:46 PM
You can say zig or c++ should have borrow checking but how? The closest thing to a spec is a partially complete set of datalog predicates in the polonius mdbook
🎉 mdbook-docs-l10n is published!
🚀 Preview:
projects.localizethedocs.org/mdbook-docs-...
🌐 Crowdin:
localizethedocs.crowdin.com/mdbook-docs-...
🐙 GitHub:
github.com/localizethed...
#Crowdin #GitHub #mdBook #Rust
🚀 Preview:
projects.localizethedocs.org/mdbook-docs-...
🌐 Crowdin:
localizethedocs.crowdin.com/mdbook-docs-...
🐙 GitHub:
github.com/localizethed...
#Crowdin #GitHub #mdBook #Rust
GitHub - localizethedocs/mdbook-docs-l10n: Localization of mdBook Documentation
Localization of mdBook Documentation. Contribute to localizethedocs/mdbook-docs-l10n development by creating an account on GitHub.
github.com
November 22, 2025 at 7:43 AM
🎉 mdbook-docs-l10n is published!
🚀 Preview:
projects.localizethedocs.org/mdbook-docs-...
🌐 Crowdin:
localizethedocs.crowdin.com/mdbook-docs-...
🐙 GitHub:
github.com/localizethed...
#Crowdin #GitHub #mdBook #Rust
🚀 Preview:
projects.localizethedocs.org/mdbook-docs-...
🌐 Crowdin:
localizethedocs.crowdin.com/mdbook-docs-...
🐙 GitHub:
github.com/localizethed...
#Crowdin #GitHub #mdBook #Rust
So basically, Tracey has its own markdown processing pipeline. There's no integration with something like MDbook right now, because I don't use MDbook, I use my own static site generator. But the basic building blocks could be integrated in other things, including MDbook.
February 21, 2026 at 11:58 AM
So basically, Tracey has its own markdown processing pipeline. There's no integration with something like MDbook right now, because I don't use MDbook, I use my own static site generator. But the basic building blocks could be integrated in other things, including MDbook.
okay, enough people wanted to see this that i feel like a gist is good enough, so i threw this together
gist.github.com/steveklabnik...
gist.github.com/steveklabnik...
An {#trycmdinclude} for mdbook (based on work by @bryceberger)
An {#trycmdinclude} for mdbook (based on work by @bryceberger) - README.md
gist.github.com
February 6, 2025 at 4:56 PM
okay, enough people wanted to see this that i feel like a gist is good enough, so i threw this together
gist.github.com/steveklabnik...
gist.github.com/steveklabnik...
Started writing some high level docs for ergot. Decided to use rustdoc instead of mdbook, since it's easier to keep examples tested and up to date. Still more to do, but it's a start:
docs.rs/ergot/latest...
docs.rs/ergot/latest...
ergot::book - Rust
`ergot` - An Introduction
docs.rs
June 29, 2025 at 11:36 PM
Started writing some high level docs for ergot. Decided to use rustdoc instead of mdbook, since it's easier to keep examples tested and up to date. Still more to do, but it's a start:
docs.rs/ergot/latest...
docs.rs/ergot/latest...
“Rustdoc should use mdbook as a library” ahhhhh been saying this for like, literal years
February 7, 2024 at 9:51 PM
“Rustdoc should use mdbook as a library” ahhhhh been saying this for like, literal years
Bir haftadır mdbook kullanarak bir c++ sitesi oluşturmaya çalışıyorum. Site kolay içerik sorun ve notlarımı sonunda aktardım. 40 sayfalık bir şey kaldı sonra githubda yayınlarım. Çok ilgi çekecek birşey değil ama en azından hakkımda bir bilgi oluşturur ahmaklarla diyaloğum azalır.
March 3, 2025 at 3:36 AM
Bir haftadır mdbook kullanarak bir c++ sitesi oluşturmaya çalışıyorum. Site kolay içerik sorun ve notlarımı sonunda aktardım. 40 sayfalık bir şey kaldı sonra githubda yayınlarım. Çok ilgi çekecek birşey değil ama en azından hakkımda bir bilgi oluşturur ahmaklarla diyaloğum azalır.
so it seems like (I haven't verified) colorizing adds lines sometimes. so the line numbers in the mdbook include have to correspond to the colorized output, and not the input. so that's totally fine, just means that it takes some experimentation to find the correct lines
BUT!!!!
BUT!!!!
February 6, 2025 at 2:42 PM
so it seems like (I haven't verified) colorizing adds lines sometimes. so the line numbers in the mdbook include have to correspond to the colorized output, and not the input. so that's totally fine, just means that it takes some experimentation to find the correct lines
BUT!!!!
BUT!!!!