48 lines
1.9 KiB
Markdown
48 lines
1.9 KiB
Markdown
# Memos Clipper — Chrome Extension
|
|
|
|
Clip any web page or selection as Markdown directly to your [usememos](https://usememos.com) instance. Images are uploaded as attachments. Preview and edit before sending.
|
|
|
|
## Features
|
|
|
|
- **Full page or selection** — clip the whole article (auto-extracted) or just what you've selected
|
|
- **Markdown preview** — live rendered preview with syntax highlighting
|
|
- **Edit before send** — tweak the Markdown in the built-in editor
|
|
- **Image attachments** — images found on the page are uploaded as resources; toggle per-image
|
|
- **Visibility control** — Private / Protected / Public per memo
|
|
- **Source attribution** — automatically prepends a blockquote with the source URL and title
|
|
|
|
## Installation
|
|
|
|
1. Open Chrome and go to `chrome://extensions/`
|
|
2. Enable **Developer mode** (top right toggle)
|
|
3. Click **Load unpacked**
|
|
4. Select this folder (`memos-extension/`)
|
|
|
|
## Configuration
|
|
|
|
1. Click the extension icon → **⚙ settings gear** (or right-click → Options)
|
|
2. Enter your Memos instance URL, e.g. `https://memos.example.com`
|
|
3. Generate an access token in Memos: **Settings → Account → Access Tokens**
|
|
4. Paste the token and click **Save Settings**
|
|
5. Click **Test Connection** to verify
|
|
|
|
## Usage
|
|
|
|
1. Navigate to any web page
|
|
2. *(Optional)* Select text you want to clip
|
|
3. Click the Memos Clipper icon in the toolbar
|
|
4. The page (or selection) is extracted as Markdown
|
|
5. Edit if needed, check the **Preview** tab
|
|
6. Adjust visibility and image settings
|
|
7. Click **Send to Memos**
|
|
|
|
## API compatibility
|
|
|
|
Tested against usememos **v0.22+** (uses `/api/v1/memos` and `/api/v1/resources`).
|
|
|
|
## Notes
|
|
|
|
- Images on cross-origin pages may fail to upload due to CORS restrictions — these will be skipped gracefully
|
|
- The extension uses Chrome's `scripting` permission to inject the content extractor on demand
|
|
- No data is ever sent anywhere except your own Memos instance
|