Ledge.sh
Desktop app for Markdown notes with runnable shell command blocks.
HN commenters mostly praise the idea rather than long-term use: runnable documentation that keeps notes and frequently run commands in one Markdown file,1234 with some seeing it as an alternative to Jupyter Notebooks or org-babel-style workflows.56 The main caveat is a warning against putting crucial code blocks in Markdown for serious project management,7 and one commenter expects the existing tool xc to suit their needs better.8
Why people recommend it
Runnable docs · 3
Commenters like being able to run documentation directly while reading it.
“I love the idea of having documentation that I can just run directly as I'm reading through it”
“Love this concept, simple but brilliant idea with lots of utility.”
Show 1 more
“I think xc is probably more suited for my uses”
Process automation · 1
Seen as a good fit for incrementally automated 'do nothing scripts' and baked-in observability queries.
“Nice, I'll have to give this a try.”
Jupyter alternative · 1
Suggested as a Markdown alternative to Jupyter, avoiding the notebook JSON bloat that trips up agents.
“This seems like a good alternative to Jupyter Notebooks.”
GUI · 1
One commenter was drawn by its GUI after finding Atuin Desktop's performance poor.
“I love the idea of having documentation that I can just run directly as I'm reading through it”
Caveats and dissent
Not for critical work · 1
One commenter calls crucial code blocks in Markdown an anti-pattern for serious project management.
“I advise against using this for any serious project management. Nontrivial and/or crucial code-blocks in markdown files is an anti-pattern.”
Existing alternatives · 2
Similar tools like xc and Atuin Desktop exist, and one user expects xc to suit them better.
“I think xc is probably more suited for my uses”
“I love the idea of having documentation that I can just run directly as I'm reading through it”
Missing features · 2
Commenters asked for a Jupyter-like notebook mode and PDF export.
“This seems like a good alternative to Jupyter Notebooks.”
“Great idea!”
Often compared with
Who recommends it in their own words
From the makers not counted in the ranking
“support for Ledge notebooks degrades gracefully.”
“So I use Ledge to run my automation scripts, do some manual checks, based on those run more automations”
Threads where it came up
- Show HN: Ledge.sh – Runnable Markdown Notes 9 mentions
Also written as Ledge. Data: ledge-sh.json. Quotes are verbatim; the verdict and theme labels are written by a model from these comments, and every clause links to its sources.
All comments 7
“I advise against using this for any serious project management. Nontrivial and/or crucial code-blocks in markdown files is an anti-pattern.”
“Nice, I'll have to give this a try.”
“Great idea!”
“This seems like a good alternative to Jupyter Notebooks.”
“I think xc is probably more suited for my uses”
“Love this concept, simple but brilliant idea with lots of utility.”
“I love the idea of having documentation that I can just run directly as I'm reading through it”