[**English**](./README.md) | [**简体中文**](./docs/README_zh.md) | [**繁體中文**](./docs/README_zh-tw.md) | [**日本語**](./docs/README_ja.md) | [**한국어**](./docs/README_ko.md)

---

# ChatGPT Math Clipboard

An Obsidian desktop plugin that copies ChatGPT formulas from the built-in Web
Viewer as Markdown that renders correctly in your notes.

When the user clicks ChatGPT's native copy button, the plugin reads the
rendered response DOM and copies strict Obsidian Markdown:

- inline KaTeX becomes `$...$`
- display KaTeX becomes `$$...$$`
- the clipboard contains plain text only, preventing rich HTML paste handling

The plugin does not guess whether brackets are formulas. It only converts
KaTeX nodes that expose an `application/x-tex` annotation. If ChatGPT changes
its DOM and strict extraction fails, native copy behavior is preserved.

## Privacy and external services

- The plugin runs locally inside Obsidian.
- It only activates for Web Viewer pages whose host is exactly `chatgpt.com`.
- It reads the rendered DOM of the ChatGPT response whose native copy button
  you click and replaces that clipboard write with local plain-text Markdown.
- It does not make network requests, store account data, or upload note,
  conversation, or clipboard content.
- ChatGPT itself remains an external service governed by its own terms and
  privacy policy.

## Requirements

- Obsidian desktop with the core Web Viewer plugin enabled
- A ChatGPT tab opened inside Web Viewer

This version was validated against Obsidian `1.12.7` and the ChatGPT DOM
available on May 30, 2026.

## Development

```bash
npm install
npm test
npm run build
```

The publishable files are written to:

```text
release/chatgpt-math-clipboard/
```

Install the directory under:

```text
<vault>/.obsidian/plugins/chatgpt-math-clipboard/
```