# Cross-App Notes Bridge

[English](README.md) · [简体中文](README.zh-CN.md)

An [Obsidian](https://obsidian.md) plugin that exports notes as portable Markdown and bridges your vault with other note-taking apps — Bear (via `x-callback-url`), WPS Cloud Note, Youdao Note, and Flomo (via their respective CLI/MCP clients).

Mobile-safe: stdio MCP transports and Bear are guarded at runtime and degrade gracefully on iOS/Android.

![Right-click submenu showing Copy as pure Markdown, Bear, WPS Cloud Note, Youdao Note, and Flomo actions](docs/screenshots/context-menu.png)

## Why one plugin instead of four?

These integrations share the same pipeline — selection → Markdown transforms → provider dispatch — and most users who care about Markdown portability use more than one of these apps. Bundling avoids duplicating the transform layer and keeps the right-click menu unified. Each provider can be enabled/disabled and trusted independently in settings, so you only see what you configure.

The plugin is intentionally scoped to **first-class clients** for these apps; there is no generic "add any MCP server" UI yet, because no single integration shape works across arbitrary MCP servers. New providers will be added as first-class clients in future versions.

## Features

### Export as pure Markdown

Transform Obsidian-specific syntax into portable Markdown that works anywhere:

- **Copy as pure Markdown** — transform the active note and copy to clipboard.
- **Export to folder** — write transformed notes to a configurable export directory.

#### Transform options

| Option | Description | Default |
|--------|-------------|---------|
| Resolve `[[wikilinks]]` | Convert wikilinks to standard Markdown links | On |
| Embed handling | What to do with `![[embeds]]` | Replace with link |
| Flatten callouts | Convert `> [!note]` callouts to blockquotes | On |
| Drop frontmatter | Remove YAML frontmatter from output | Off |
| Rewrite attachments | How to handle image/attachment paths | Vault-relative |

### Bear (macOS / iOS)

- **Send active note to Bear** — dispatched via `bear://x-callback-url/create`. Tags from frontmatter are preserved.
- **Import from Bear** — enter a note UUID or Bear URL; the plugin opens Bear and writes the returned content into your vault.

### WPS Cloud Note (desktop)

Send notes to WPS Cloud Note via the WPS Note CLI or its MCP server endpoint. Configure transport, command path, and headers in settings.

### Youdao Note (desktop)

Send notes to Youdao Note via the official `youdaonote` CLI. The plugin can detect the CLI, push your API key to it, and run a connection test from settings.

### Flomo

Export memos to Flomo via its official streamable-HTTP MCP server at `https://flomoapp.com/mcp`. Requires a Flomo Pro account and a personal API token, configured per provider in settings. Push-only — Flomo's MCP is a write surface today, so importing memos back into the vault isn't supported.

### Context menu

Right-click any file in the file explorer (or select multiple files) to find the **Cross-App Notes Bridge** submenu with all available actions.

## Settings

Configure via **Settings → Community plugins → Cross-App Notes Bridge**.

- **Export folder** — directory for exported notes (default: `Exports`)
- **Import folder** — directory for imported notes (default: `Imports`)
- **Concurrency** — parallel export workers (default: 4)
- **Transform options** — configure Markdown output format
- **Providers** — enable, trust, and configure Bear / WPS / Youdao / Flomo independently

## Commands

| Command | Description |
|---------|-------------|
| `Copy as pure Markdown` | Transform and copy the active note to clipboard |
| `Export current note as pure Markdown` | Export the active note to folder |
| `Send active note to Bear` | Dispatch the active note to Bear |
| `Import from Bear` | Import a Bear note via UUID or URL |
| `Send active note to WPS Cloud Note` | Dispatch the active note to a configured WPS provider |
| `Send active note to Youdao Note` | Dispatch the active note to a configured Youdao provider |
| `Send active note to Flomo` | Dispatch the active note as a memo to a configured Flomo provider |

## Installation

### Via BRAT (recommended for beta testing)

The plugin isn't in the official community catalogue yet. The easiest way to install and stay up-to-date is through [BRAT (Beta Reviewers Auto-update Tool)](https://github.com/TfTHacker/obsidian42-brat):

1. Install **BRAT** from **Settings → Community plugins → Browse**, then enable it.
2. Open **Settings → BRAT → Add Beta plugin** and paste `huangcheng/cross-app-notes-bridge`.
3. BRAT downloads the latest release into your vault and tracks new versions automatically.

See the [BRAT plugin docs](https://tfthacker.com/brat-plugins) for details on auto-updates and pinning to a specific version.

### From GitHub release

1. Download `main.js`, `manifest.json`, and `styles.css` from the [latest release](https://github.com/huangcheng/cross-app-notes-bridge/releases).
2. Copy them into `<vault>/.obsidian/plugins/advanced-import-export/`.
3. Enable the plugin in **Settings → Community plugins**.

### Build from source

```bash
git clone https://github.com/huangcheng/cross-app-notes-bridge.git
cd cross-app-notes-bridge
npm install
npm run build
```

Copy the output files (`main.js`, `manifest.json`, `styles.css`) into your vault's plugin directory.

## Development

```bash
npm install        # install dependencies
npm run dev        # watch mode — auto-rebuild on changes
npm run build      # production build
npm run lint       # run ESLint
```

## Privacy

- **No telemetry.** The plugin does not call any analytics, tracking, or "phone home" endpoint.
- **Credentials stay local.** API keys and provider configuration are stored in your vault's plugin data file (`.obsidian/plugins/advanced-import-export/data.json`) and never leave your machine, except for the explicit calls you trigger to the configured provider (e.g. WPS server endpoint, Youdao CLI subprocess, Bear's URL scheme).
- **Network calls are scoped to the provider you configure.** Disabling or untrusting a provider stops all calls for that provider.
- **Outbound URLs:** Bear → `bear://` URL scheme (local IPC, no network); WPS → the server URL or CLI binary you configure; Youdao → the local `youdaonote` CLI (calls Youdao's API on your behalf using the API key you provide it); Flomo → `https://flomoapp.com/mcp` with `Authorization: Bearer <your-token>`.

## License

[MIT](LICENSE)