61 lines
1.7 KiB
Markdown
61 lines
1.7 KiB
Markdown
# 🔗 Public Sharing
|
|
|
|
Share notes publicly without requiring viewers to log in.
|
|
|
|
## How It Works
|
|
|
|
1. Open a note you want to share
|
|
2. Click the **Share** button in the toolbar
|
|
3. Click **Create Share Link**
|
|
4. Copy the generated URL or click **Show QR Code** for easy mobile scanning
|
|
|
|
The recipient can view the note in their browser - no account needed.
|
|
|
|
## Revoking Access
|
|
|
|
To stop sharing a note:
|
|
1. Open the note
|
|
2. Click the **Share** button
|
|
3. Click **Revoke Link**
|
|
|
|
The old URL will immediately stop working.
|
|
|
|
## Features
|
|
|
|
- **Theme preserved** - Shared notes display with the theme active when you created the link
|
|
- **Images embedded** - All images are included in the shared view
|
|
- **Code highlighting** - Syntax highlighting works in shared notes
|
|
- **Copy button** - Code blocks have a copy-to-clipboard button
|
|
- **MathJax & Mermaid** - Math equations and diagrams render correctly
|
|
- **QR code** - Generate a QR code for easy mobile sharing
|
|
- **No expiration** - Links work until you revoke them
|
|
|
|
## Visual Indicators
|
|
|
|
- A **share icon** appears next to shared notes in the sidebar
|
|
- The Share modal shows the current sharing status
|
|
|
|
## Technical Details
|
|
|
|
### Token Storage
|
|
|
|
Share tokens are stored in `.share-tokens.json` in your data folder:
|
|
|
|
```json
|
|
{
|
|
"LRFEo86oSVeJ3Gju": {
|
|
"path": "folder/note.md",
|
|
"theme": "dracula",
|
|
"created": "2026-01-15T10:30:00+00:00"
|
|
}
|
|
}
|
|
```
|
|
|
|
Each note can have one share token. Creating a new link for an already-shared note returns the existing token.
|
|
|
|
### Security
|
|
|
|
- Tokens are random 16-character strings
|
|
- Only the exact token URL grants access
|
|
- Revoking deletes the token permanently
|
|
- Shared notes are read-only (viewers cannot edit) |