‹ BackHN Continuity

Thread

Show HN: Ledge.sh – Runnable Markdown Notes

204 points · 88 comments · dancablam

  1. Piraty · · focus · HN ↗
    > I built Ledge because I spend much of my day copy/pasting commands from my notes into the terminal. I was inspired by how much cmux helped me organize my terminals - but there was still a split brain between my notes and frequently Run commands. I've been daily-driving it for the past few weeks and use it for deploys, API calls, smoke tests, etc.

    I see it might be handy for exploring your own pipelines (and so are things like <a href="https:&#x2F;&#x2F;github.com&#x2F;akavel&#x2F;up&#x2F;" rel="nofollow">https:&#x2F;&#x2F;github.com&#x2F;akavel&#x2F;up&#x2F; ) , but I advise against using this for any serious project management. Nontrivial and&#x2F;or crucial code-blocks in markdown files is an anti-pattern.

    Once i find I&#x27;m re-using code from my markdown notes, I make it a script in ${dotfiles}&#x2F;bin or in ${project}&#x2F;scripts and put related docs in there. This feels like the inverse of this tool&#x27;s imposed workflow and has the upside of composability of tools.

    Then use something like a makefile to call these tools&#x2F;scripts behind generic phony targets (or you can roll your own &#x27;project.sh&#x27; entry point script if really needed). It then becomes just `make release`. it is portable already and does not add yet another host dependency on everybody nor a fricking javascript engine.

    ps1: Same goes for weird stuff like <a href="https:&#x2F;&#x2F;pypi.org&#x2F;project&#x2F;taskipy&#x2F;" rel="nofollow">https:&#x2F;&#x2F;pypi.org&#x2F;project&#x2F;taskipy&#x2F; . use `make release` over `poetry run task release`

    ps2: if you&#x27;re copy&#x2F;pasting-workflow sucks: improve it. vim has :Terminal, it has yank-to-clipoard etc.

    1. dancablam · · focus · HN ↗
      Ledge doesn&#x27;t remove the need to write scripts &#x2F; automations. But for things like complex deploy pipelines there are still many manual &#x2F; human steps in between. So I use Ledge to run my automation scripts, do some manual checks, based on those run more automations, etc.
Open on Hacker News to reply ↗

Unofficial Hacker News client; not affiliated with Y Combinator.