Web viewer Bookmarks

Web viewer Bookmarks

A simple community plugin for Obsidian that allows you to create and manage bookmarks for websites when using Obsidian's built-in web viewer.

Features

• Create and manage website bookmarks for quick access in Obsidian's built-in web viewer
• Add bookmarks to the Obsidian ribbon for one-click access
• Access bookmarks via commands in the command palette
• Customize bookmark icons using Lucide icon names

Installation

1. In Obsidian, go to Settings → Community plugins
2. Disable Safe mode
3. Click "Browse" and search for "Web viewer Bookmarks"
4. Install the plugin
5. Enable the plugin in your list of installed plugins

Manual Installation

1. Create a folder named webviewer-bookmarks in your vault's .obsidian/plugins/ directory
2. Download the main.js, manifest.json, and styles.css files from the latest release
3. Add them to the plugin folder
4. Enable the plugin in your Obsidian settings

Managing Bookmarks

1. Go to Settings → Web viewer Bookmarks
2. Here you can:
   • Add bookmarks
   • Edit existing bookmarks
   • Delete bookmarks
   • Change icons

Customizing Icons

The plugin uses Lucide icons for bookmark visuals. To set an icon:

1. Browse the Lucide icon library to find the icon name you want
2. Enter the icon name exactly as it appears (e.g., "book-marked", "globe", "bookmark")

Ribbon and Command Integration

For each bookmark, you can choose to:

• Add a ribbon icon for one-click access
• Create a command in the command palette

Note: After making changes to bookmarks, Obsidian must be reloaded for the changes to take effect.

Using {{selection}} in bookmarks

• You can include the template {{selection}} in a bookmark URL to insert the currently selected text from the active Markdown editor.
• Example URL for a search engine: https://www.duckduckgo.com/?q={{selection}}
• If you select the word duck in a Markdown note and run that bookmark, the plugin will open https://www.duckduckgo.com/?q=duck (the selection is URL-encoded).

Encoding details:

• The plugin uses percent-encoding via encodeURIComponent for the inserted selection. That means spaces become %20 and special characters are encoded according to standard URL percent-encoding rules. This is the safest and most compatible default behavior.
• If nothing is selected in the active Markdown editor, the {{selection}} placeholder is replaced with an empty string (the URL will open without a search term).

Notes and limitations:

• The selection is read from the active Markdown editor (Obsidian's MarkdownView.editor.getSelection()). It does not (currently) read selections from embedded webviews or iframes.
• Some sites expect + instead of %20 for spaces (form-style encoding). The plugin uses percent-encoding by default to avoid surprises; if you need site-specific behavior you can adapt the bookmark URL accordingly.

Troubleshooting

• Bookmarks not appearing: Reload Obsidian after making changes
• Icons not displaying correctly: Ensure you're using valid Lucide icon names
• Web viewer not opening: Check that Obsidian's built-in web viewer is enabled

Support

If you encounter any issues or have feature requests, please file an issue on the GitHub repository.

License

This plugin is licensed under the MIT License.

Credits

• Built for Obsidian's API
• Uses Lucide icons
• Inspired by the needs of the Obsidian community