Skip to content

plannotator/tot

Repository files navigation

tot
tot.page is what enables Plannotator Workspaces

tot.page

Publish a markdown or HTML file to a live link in one command. No signup.

The useful part is that it is git-backed publishing, not a one-off upload. The link you share is living, like a branch: run tot update and the same URL moves forward. Every publish also creates a real version with a frozen @hash URL, like a commit, so you can point people at either "latest" or "exactly this snapshot."

npm i -g @plannotator/tot
tot notes.md
  ↳ https://tot.page/aB3xK9q
  commit  e5f6c1a
  frozen  https://tot.page/aB3xK9q/index.md@e5f6c1a

Commands

Command What it does
tot notes.md Publish markdown as the raw .md file.
tot page.html Publish HTML as the raw .html file, plus local support files it directly references.
tot update <link> Push new content. The same link updates.
tot list Show what you have published.
tot remove <link> Remove the living page from its share link.
tot login --key <key> Optional. Publish as an owned account instead of anonymous.

How it works

Files are served byte for byte. Markdown comes back as raw markdown. HTML comes back as raw HTML.

For HTML, tot also uploads direct local browser dependencies before the page goes live: images, stylesheets, scripts, video, srcset entries, and video posters. It skips external URLs and ordinary navigation links. There is no config file, build step, routing layer, or bundler.

Your link is live. Run tot update and the same tot.page/... link shows the new version. Every version also keeps a frozen @hash link that never changes, for when you want a fixed snapshot.

tot remove removes the living page. Frozen snapshot links are permanent while the workspace exists.

No accounts, no tokens. The link is the key. Treat them as you would excalidraw.

A page you publish is open. Anyone who has the link can view it, update it, or delete it. There is no private mode. Share the link with that in mind.

Configuration

State lives in ~/.tot: the API endpoint and the list of pages you have published. Override the API origin for one run with --endpoint <url>.

Built on

Cloudflare Artifacts. Every version is a real git commit.

License

MIT

About

publish any html or markdown to an instant link you can share - backed by git

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors