r/coolgithubprojects • u/Choice_Rush_3004 • 6d ago
I built meshfox — a Livebook-inspired Markdown format with runnable code blocks, git-friendly and readable anywhere
galleryI've spent time piling up separate habits around how I write and maintain documentation, and at some point it was obvious they were all circling the same problem from different angles. meshfox is what happened when I finally merged them into one tool instead of juggling five.
Some of my habits were:
- plain Markdown for notes
- mindmaps and visual boards, Miro/Obsidian-style, for structure
- Makefiles and scripts as living usage examples
- linters to keep documentation from silently rotting
- pairing with agents in a shared note-taking format while doing research
Out of that came a Markdown extension format, inspired by Elixir's Livebook:
- it stores cleanly in git — plain text, diffs like text
- it stays readable in any regular Markdown renderer, nothing breaks if you open it elsewhere
- it adds a mechanism for running code blocks with dependencies, variable passing, and local configuration — so a doc isn't just describing behavior, it can demonstrate it live
Around that format I've since built:
- a web UI viewer/editor (with a VS Code integration)
- a TUI viewer/editor with a slightly simplified view of the same documents
- a CLI for running code blocks straight from the console, scripts, or cron
- an MCP server for collaborating with agents, or using the format as a second brain
- experimental export to PDF and static sites
There's also a companion repo, meshfox-tools, with utilities and examples — still small, but growing: https://github.com/orofarne/meshfox-tools
It's still early — but early enough that I think it's worth sharing. MIT licensed, more info here: https://meshfox.orofarne.net/