Documentation
Last updated: January 30, 2026
Ramble is a collaborative Markdown editor. This page explains the concepts that aren’t obvious from the interface itself.
Sharing & Access
Ramble has three ways to control who can access a draft: link sharing, public access, and workspaces.
Link Sharing
Every draft has a unique URL. Link sharing controls what happens when someone visits that URL.
| Setting | Who can access | What they can do |
|---|---|---|
| Off | Only you (and workspace members) | — |
| View | Anyone with the link | Read only |
| Edit | Anyone with the link | Read and edit |
When link sharing is off, the URL still exists but returns an access error.
The 3-Collaborator Limit
Link-edit access allows up to 3 concurrent editors. This limit exists to encourage workspaces for team collaboration—workspaces have no editor limit.
Who counts toward the limit: Anyone editing via the shared link.
Who doesn’t count: You (the draft author) and workspace members.
When the limit is reached: New visitors see an error message and can retry when someone leaves.
Public Access
Public access is a separate toggle from link sharing. When enabled, anyone can view the draft without signing in.
- Requires link sharing to be on (view or edit)
- Automatically disabled when you turn off link sharing
- Useful for documentation, blog posts, or anything you want indexed
Access Changes
When you disable link sharing, all link-based collaborators are disconnected immediately. Their cursors disappear and they can no longer edit.
When you move a draft to a different workspace, old workspace members lose access and new workspace members gain access. Link-based access is unaffected.
Workspaces
A workspace is a shared container for drafts. Everyone in the workspace can access all drafts in it.
Roles
| Role | See drafts | Edit drafts | Add drafts | Manage members | Delete workspace |
|---|---|---|---|---|---|
| Owner | ✓ | ✓ | ✓ | ✓ | ✓ |
| Editor | ✓ | ✓ | ✓ | — | — |
| Viewer | ✓ | — | — | — | — |
Each workspace has exactly one owner.
Draft Ownership
You always own your drafts, even in a workspace. Workspace membership grants access, not ownership.
This means:
- You control sharing settings for your drafts
- You can move your drafts out of the workspace at any time
- If you leave the workspace, your drafts come with you
Leaving a Workspace
When you leave a workspace:
- Your authored drafts move to your My Drafts
- You lose access to other members’ drafts
- Your edits to others’ drafts remain (you contributed, not owned)
Workspace Deletion
When a workspace is deleted, all drafts return to their respective authors’ My Drafts. No content is lost—just reorganized.
Your Data
What Ramble Stores
| Data | Where | Purpose |
|---|---|---|
| Draft content | Real-time sync storage + database | Collaboration and persistence |
| Draft metadata | Database | Title, timestamps, sharing settings |
| Your profile | Database | Display name, email, timezone |
| Edit history | Real-time sync storage | Undo/redo, conflict resolution |
Ramble does not store your IP address, only a cryptographic hash for rate limiting.
Offline Editing
When you lose connection:
- Edits are saved locally in your browser
- The editor continues to work normally
- Changes sync automatically when you reconnect
- If conflicts occur, changes are merged (not overwritten)
You’ll see a connection indicator in the editor when offline.
Trash & Deletion
Deleted drafts go to Trash, where they’re recoverable for 30 days.
When you restore a draft:
- It returns to My Drafts (not its original workspace)
- Sharing settings are cleared (you’ll need to re-share)
After 30 days, drafts are permanently deleted and cannot be recovered.
Quick Reference
Common scenarios and what happens:
| Event | Result |
|---|---|
| I disable link sharing | All link-based collaborators disconnected immediately |
| I move a draft to a workspace | Old workspace members lose access; new members gain access |
| Someone removes me from a workspace | My drafts move to My Drafts; I lose access to others’ drafts |
| A workspace is deleted | All drafts return to their authors’ My Drafts |
| I delete a draft | Goes to Trash (recoverable for 30 days) |
| The 3-editor limit is reached | New link visitors see an error; can retry when someone leaves |
| I go offline | Edits save locally; sync when reconnected |
| I restore from Trash | Draft returns to My Drafts with sharing settings cleared |
Questions? Contact hello@ramble.md.