Document Sharing
Sharing Modes
Every document in Notery has one of three sharing modes:
| Mode | Visibility | Use Case |
|---|---|---|
| Private | Only you (the workspace owner) can access it. | Default for all new documents. Use for personal notes and drafts. |
| Unlisted | Anyone with the direct link can view it. Not discoverable via search engines. | Share with teammates or reviewers without making it fully public. |
| Public | Discoverable and accessible by anyone. | Publish documentation, blog-style posts, or reference material. |
How to Share a Document
Toggle sharing from the document metadata panel in the editor:
- Open the document you want to share.
- Open the metadata panel (sidebar).
- Select the desired sharing mode — Unlisted or Public.
- Copy the generated share link.
You can switch between sharing modes at any time. Changing from Unlisted or Public back to Private immediately revokes access for anyone with the link.
Share URLs
Shared documents are accessible at:
https://notery.dev/s/{id}
This URL is stable and will work as long as the document remains in an Unlisted or Public state.
What Shared Views Include
The shared view renders your markdown in read-only mode with full formatting:
- Headings, lists, tables, and code blocks render with proper styling.
- Wiki-links within the document are rendered as plain text (they do not link to your private workspace).
- Syntax highlighting is applied to fenced code blocks.
Security and Privacy
Sharing a document does not expose your API key, workspace, or any other documents. Only the specific document content is visible to viewers.
- Shared links contain a unique document identifier — they cannot be guessed or enumerated.
- Viewers cannot edit, delete, or access metadata beyond what is rendered in the shared view.
- Your workspace structure (folders, other documents, tags) is never visible to external viewers.
Revoking Access
To stop sharing a document, toggle its sharing mode back to Private. This takes effect immediately:
- The share URL will return a 404 error.
- Anyone who previously had the link will no longer be able to access the content.
- No cached copies are served after access is revoked.
Revoking access does not prevent someone from having already copied the content. If sensitive information was shared by mistake, consider it potentially exposed.