# Side Bookmark

[中文说明 (Chinese Version)](#中文版-side-bookmark)

Side Bookmark is an Obsidian plugin that embeds a fully functional web browser right in your sidebar. It allows you to browse websites, collect references, and manage your bookmarks without ever leaving your vault.

## Features

- 🌐 **In-App Browser**: Open and navigate any web page directly within the Obsidian sidebar.
- 🔖 **Bookmark Management**: Save frequently visited sites as bookmarks. Organize them effectively using folders.
- 🖱️ **Drag-and-Drop Organization**: Easily reorder and organize your bookmarks and folders via an intuitive drag-and-drop interface.
- 🔗 **Link Interception**: Optionally intercept clicks on external links in your notes (supports both Reading View and Live Preview) to open them seamlessly within the built-in browser instead of your system browser.
- 💾 **Persistent Settings**: Your bookmarks, folders, and browser preferences are securely saved within your vault.

## Installation

### Manual Installation
1. Download `main.js`, `styles.css`, and `manifest.json` from the [Releases](https://github.com/bcs1037/side-bookmark/releases) page.
2. Create a folder named `side-bookmark` inside `.obsidian/plugins/` in your vault.
3. Place the downloaded files into the `side-bookmark` folder.
4. Reload Obsidian and enable **Side Bookmark** in the Community Plugins settings.

---

# 中文版 Side Bookmark

Side Bookmark 是一款强大的 Obsidian 插件，可以在您的侧边栏中嵌入一个功能完整的网页浏览器。它能让您在不离开笔记库的情况下，直接浏览网页、收集参考资料并管理书签。

## 主要功能

- 🌐 **应用内浏览器**：直接在 Obsidian 侧边栏中打开流转和浏览任意网页。
- 🔖 **书签管理**：将频繁访问的网站保存为书签，并使用文件夹对它们进行高效整理。
- 🖱️ **拖拽排序管理**：通过直观的拖放界面，轻松对书签和文件夹进行重新排序和组织。
- 🔗 **拦截笔记链接**：提供可选开关，开启后自动拦截笔记中的外部链接点击（全面支持阅读视图与实时预览），在侧边栏无缝打开目标网页。按住 Cmd/Ctrl 单击可临时绕过。
- 💾 **设置持久化**：您的书签、文件夹和浏览器偏好设置都安全的保存在您的笔记库中。

## 安装方法

### 手动安装
1. 前往 GitHub 的 [Releases](https://github.com/bcs1037/side-bookmark/releases) 页面，下载最新的 `main.js`、`styles.css` 和 `manifest.json` 文件。
2. 在您的 Obsidian 笔记库的 `.obsidian/plugins/` 目录下创建一个名为 `side-bookmark` 的文件夹。
3. 将下载的文件放入该文件夹中。
4. 重新加载 Obsidian，并在“第三方插件”设置中启用 **Side Bookmark**。

## Acknowledgments / 致谢

This plugin is built upon the [Obsidian Sample Plugin](https://github.com/obsidianmd/obsidian-sample-plugin) template. We thank the Obsidian team and community for providing such a robust foundation.

本项目是基于 [Obsidian Sample Plugin](https://github.com/obsidianmd/obsidian-sample-plugin) 模板开发构建的。在此特别感谢 Obsidian 官方及社区提供的优秀基础框架。