SmallDocs: a tiny CLI and web app for private Markdown reading and sharing

What it is

SmallDocs showed up on Hacker News as a Show HN post — a compact tool that pairs a command-line interface with a web front end to read and share Markdown files privately. It has been reported that the author positions it as a lightweight, local-first alternative to bloated note apps: run a small server from your machine, open a browser, and read Markdown in a tidy, web-friendly view. Simple. No cloud lock-in. Feels a bit like a breath of fresh air if you’re tired of syncing everything to someone else’s servers.

How it aims to work

Readers on the thread noted that SmallDocs focuses on minimalism and control. It allegedly supports private sharing options (temporary links or local-network access were mentioned), and the UI leans into quick readability rather than feature overload. Some commenters praised the no-friction setup; others wanted integrations — sync, search, or Git hooks — which, if added, could shift the project from neat toy to real daily driver.

Why people care

Why care about another Markdown tool? Because privacy and simplicity are trending again. Not everyone wants a subscription app or a heavy Electron client just to read notes. The emotional center here is control: your documents, on your machine, served the way you want. That struck a chord with users who described relief — small, but meaningful — at having an escape hatch from the “log in to view” world.

Interested? The original Hacker News thread links to the project and demo for anyone who wants to kick the tires and see whether SmallDocs is the tiny tool they’ve been waiting for.

Sources: Hacker News