SmallDocs – Markdown without the frustrations

Hi HN, I’d like to introduce you to SmallDocs (https://sdocs.dev). SDocs is a CLI + webapp to instantly and 100% privately elegantly preview and share markdown files. (Code: https://github.com/espressoplease/SDocs)The more we work with command line based agents the more `.md` files are part of our daily lives. Their output is great for agents to produce, but a little bit frustrating for humans: Markdown files are slightly annoying to read/preview and fiddly to share/receive. SDocs was built to resolve these pain points.If you `sdoc path/to/file.md` (after `npm i -g sdocs-dev`) it instantly opens in the browser for you to preview (with our hopefully-nice-to-look-at default styling) and you can immediately share the url.The `.md` files our agents produce contain some of the most sensitive information we have (about codebases, unresolved bugs, production logs, etc.). For this reason 100% privacy is an essential component of SDocs.To achieve this SDoc urls contain your markdown document's content in compressed base64 in the url fragment (the bit after the `#`):https://sdocs.dev/#md=GzcFAMT...(this is the contents of your document)...The cool thing about the url fragment is that it is never sent to the server (see https://developer.mozilla.org/en-US/docs/Web/URI/Reference/F...: "The fragment is not sent to the server when the URI is requested; it is processed by the client").The sdocs.dev webapp is purely a client side decoding and rendering engine for the content stored in the url fragment. This means the contents of your document stays with you and those you choose to share it with, the SDocs server doesn't access it. (Feel free to inspect/get your agent to inspect our code to confirm this!)Because `.md` files might play a big role in the future of work, SDocs wants to push the boundaries of styling and rendering interesting content in markd

Hacker NewsToolAISource
0Sign in to voteCopy link

FL score

62

out of 100

Verdict

VALIDATE

high confidence

Competition

No competitor data yet

Trend

No signal yet

A privacy-first markdown previewer that embeds document content in URLs to let users share sensitive markdown without server storage.

The pain

AI agents generate markdown files containing sensitive information (code, bugs, logs). Users need to preview these files nicely and share them securely, but existing solutions either require uploads to servers or lack good styling.

The gap

No tool currently combines instant local preview + shareable links + zero-server-access for markdown. GitHub gists require accounts and uploads. Pastebin stores content server-side. Google Docs requires conversion. The URL-fragment approach is technically clever but unproven as a distribution mechanism.

Build angle

Start by validating whether developers actually share sensitive markdown files frequently enough to justify a new tool. The privacy angle is strong but may be solving for a problem users don't actively feel. Test with AI engineers who generate markdown outputs daily. If traction exists, the technical foundation is solid and defensible.

Strengths

  • Solves a real technical problem: markdown preview + sharing without server storage
  • Privacy-first architecture is genuinely differentiated and appeals to security-conscious users
  • Low friction entry point (CLI tool, instant browser preview)
  • Timing aligns with AI agent adoption creating more markdown artifacts
  • Technical implementation is clever and verifiable (users can inspect code)

Risks

  • URL length limits: base64-compressed markdown still creates very long URLs for large documents; sharing via chat/email becomes impractical
  • Unclear market size: no evidence developers frequently share sensitive markdown files; may be solving a problem that doesn't exist at scale
  • No monetization path: free tool with no obvious upsell or business model
  • Competitive pressure: GitHub, Notion, and others could add this feature in weeks
  • User discovery: how do AI engineers learn about this vs. using existing tools they already know?
  • Styling alone won't drive adoption: the core value is privacy + sharing, but users may not trust URL-based sharing for truly sensitive data anyway

Questions about this idea?

FlyBot reads the scoring and gives you a second opinion on “SmallDocs – Markdown without the frustrations”.

Open FlyBot