roommd

Crates.ioroommd
lib.rsroommd
version0.2.0
created_at2025-07-02 22:42:33.388308+00
updated_at2025-07-02 22:42:33.388308+00
descriptionWrite room plans via markdown.
homepage
repositoryhttps://github.com/772/roommd
max_upload_size
id1735657
size1,461,695
Armin Schaefer M.Sc. (772)

documentation

README

Creating building (wiring) diagrams should be as easy as writing markdown.

License: GPL3 Crate

What is RoomMD?

View simple ascii sketches of a house as 3D models with this web application. Each utf-8 character corresponts to an certain object you can describe if you want. If two rooms contain the same characters like D for _D_oor or S for Staircase e.g., the software will put these two rooms together as shown in the example. Use whatever characters you like. It is also possible to display wires that to through multiple rooms as there is no size limits to the ascii sketches.

Usage

  • Web: RoomMD WebAssembly.
  • Installed: roommd example.md (install via cargo install roommd).
  • From source: cargo run example.md (after cloning this repository).

https://github.com/user-attachments/assets/cc425997-2444-4089-b27f-a17cc8623284

Info

How to update the wasm branch in this repository

Note that after the WebAssembly branch was initially created, I deleted all files in it.

cargo b
rustup target add wasm32-unknown-unknown
cargo install wasm-bindgen-cli
git add -A && git commit -m "Update."
git push
cargo build --target wasm32-unknown-unknown --release
wasm-bindgen --no-typescript --target web --out-dir ./../ --out-name "wasm" ./target/wasm32-unknown-unknown/release/*.wasm
cp index.html ..
cp example.md ..
cp assets .. -r
git checkout wasm
rm assets -R
mv ../index.html .
mv ../example.md .
mv ../wasm.js .
mv ../wasm_bg.wasm .
mv ../assets .
git add wasm.js wasm_bg.wasm index.html example.md assets
git commit -m "Update wasm files."
git push -f
git checkout main
Commit count: 0

cargo fmt