Chinese Emoji Picker

A tiny, friendly Obsidian plugin that lets you search and insert emoji by Chinese keywords — no need to memorize English shortcodes like :smile:. Just type ：： followed by a Chinese word (e.g. ：：梯子, ：：开心) and a picker pops up right under your cursor. ✨

📖 中文说明见下方「中文介绍」。

✨ Features

• 🔍 Chinese keyword search — find emoji with hanzi instead of English shortcodes.
• 🗂️ 9 tabs — Recently used + 8 categories, separated from the emoji grid by a clean divider.
• 🔢 7-column grid — compact panel positioned neatly below the cursor.
• 📄 Standard Unicode characters — inserted emoji are plain text, so your .md notes stay portable everywhere.
• 👀 WYSIWYG preview — emoji are rendered with your system font; unsupported characters show as boxes in the panel, exactly as they will after insertion.
• 🏠 Fully local — no network requests at all, privacy-friendly.

📦 Installation

Method 1: BRAT (recommended for quick updates)

1. Install the BRAT plugin from Obsidian's Community Plugins.
2. Open BRAT settings → Add a beta plugin.
3. Paste the repository URL: https://github.com/bighead2425/obsidian-chinese-emoji-picker.
4. Enable Chinese Emoji Picker in Settings → Community Plugins.

Method 2: Manual

1. Download main.js, manifest.json, and styles.css from the latest release.
2. Copy them into your vault's .obsidian/plugins/cn-emoji/ folder (create the folder if needed).
3. Enable the plugin in Obsidian → Settings → Community Plugins.

🚀 Usage

1. In a note, type ：： followed by a Chinese keyword, for example ：：梯子.
2. Use ↑↓←→ to move the selection, press Enter (or click) to insert, or Esc to close.
3. The entire ：：keyword text is replaced by the selected emoji.

❓ FAQ

Q: Why do some emoji show as boxes?
A: Your system font does not yet support those Unicode characters. The box is an honest preview — the same box will appear after insertion. This is a font issue, not a bug. 🔧

Q: Does it insert images or characters?
A: Plain Unicode characters. Your notes remain self-contained and portable. 📝

Q: Does it require an internet connection?
A: No. Everything runs locally. 🏡

🛠️ Build from source

npx esbuild src/main.js --bundle --external:obsidian --format=cjs --target=es2020 --outfile=main.js

Source code and data live in src/.

📜 License

MIT © bighead

⭐ 喜欢就点个 Star 吧！

如果这个小插件让你在 Obsidian 里敲 emoji 更顺手了，欢迎到 GitHub 点一颗 ⭐，这就是对作者最大的鼓励：

👉 https://github.com/bighead2425/obsidian-chinese-emoji-picker

你的每一颗 star 都能让更多中文用户发现它，也能让我更有动力继续把它打磨得更好 💛 感谢每一位使用的朋友！

中文介绍

Chinese Emoji Picker 是一个 Obsidian 插件，让你用中文关键词搜索并插入 emoji。在笔记里输入 ：： 跟一个中文词（例如 ：：梯子、：：开心），光标下方就会弹出选择面板。

✨ 功能

• 🔍 中文关键词检索，不用记英文 shortcode
• 🗂️ 9 个标签（常用 + 8 分类），标签栏与网格之间有分隔线
• 🔢 7 列网格，面板定位在光标下方
• 📄 插入标准 Unicode 字符，.md 可移植
• 👀 所见即所得：面板内用系统字体显示 emoji；不支持的字符直接显示方框
• 🏠 纯本地运行，不联网

📦 安装

方式一：BRAT（推荐）

1. 在 Obsidian 社区插件市场安装 BRAT。
2. 打开 BRAT 设置 → Add a beta plugin。
3. 填入仓库地址：https://github.com/bighead2425/obsidian-chinese-emoji-picker。
4. 在设置 → 社区插件中启用 Chinese Emoji Picker。

方式二：手动

1. 从 Releases 下载 main.js、manifest.json、styles.css。
2. 放到 vault 的 .obsidian/plugins/cn-emoji/ 目录。
3. 在 Obsidian 设置 → 社区插件中启用。

🚀 使用

1. 输入 ：： + 中文关键词，如 ：：梯子。
2. 用方向键选择，回车或鼠标点击插入，Esc 关闭。
3. 选中的 emoji 会替换整段 ：：关键词。

❓ 常见问题

Q：为什么有些 emoji 显示成方框？
A：系统字体还不支持该 Unicode 字符。方框是真实预览，插入后也会是方框，等字体更新后自然正常。这是字体问题，不是 bug。

Q：插入的是图片还是字符？
A：标准 Unicode 字符，笔记可移植，不依赖图片。

Q：需要联网吗？
A：不需要，插件完全本地运行。

🙏 致谢 / Acknowledgements

本插件的 emoji 与中文关键词对应关系、以及 1900+ 个 emoji 数据，整理自 思源笔记 (SiYuan Notes)。感谢思源笔记社区提供的高质量数据基础（原始数据基于 Unicode CLDR 公共标准）。同时也要感谢每一位使用、反馈、点 star 的朋友 —— 是你们让这个小工具一点点变得更好 💛

The emoji-to-Chinese-keyword mapping and the 1900+ emoji dataset in this plugin are adapted from SiYuan Notes. Thanks to the SiYuan community for the solid data foundation (ultimately based on the public Unicode CLDR standard). Heartfelt thanks also go to every user who tried it, gave feedback, or left a star — you made this little tool better. 💛

📝 更新日志 / Changelog

1.0.0 🎉

首个正式发布版，感谢大家一路的支持！

• ✨ 新增「鼠标未移动则不响应 hover」总开关：输入 ：： 弹出选择框后，只要鼠标没有真正移动过，无论指针压在哪个 emoji 或分类标签上，都保持默认「全部」分类、第一个 emoji 待选；此后输入汉字筛选时选中项也不会乱跳。只有鼠标真正移动后，才恢复正常的悬停跟随（同时覆盖「刚弹出」与「键盘进入标签态」两种场景）。
• 🚀 结构优化：网格 hover 与点击改用事件委托（在容器上统一监听，仅挂一次），替代原先每次筛选都给每个 cell 逐个绑定监听器，代码更简洁、减少反复建监听的开销。
• 🐭 修复鼠标小幅移动时选中迟钝的问题：首次真正移动即按光标坐标即时选中。
• 📌 修复删字时选择框跟随光标跳来跳去的问题：面板位置在首次打开时锁定，后续只刷新内容、不重定位。
• 📝 调整插件简介为更简洁的一句描述。

0.2.4

• 标签待选态下，若当前分类没有任何 emoji 可选项，按 ↓ 方向键不做任何反应，保持标签待选态（不再误退出）。

0.2.3

• 修复：用键盘进入「标签待选态」时，若鼠标静止压在某个 emoji 上（或切换分类时网格重渲染、重建了光标下的 cell），会误触发退出标签态并选中该 emoji。现在只有进入标签态后鼠标真正移动过、再移到 emoji 上，才会退出标签态并选中。

0.2.2

• 新增双层键盘导航：网格顶行按 ↑ 进入「标签待选态」（选中当前分类标签，网格内无 emoji 选中）；标签待选态下 ← → 左右切换分类并预览，↓ 进入当前分类第一个 emoji；标签待选态下鼠标移到 emoji 即退出标签态并选中该 emoji。

0.2.1

• 修复：点击 emoji 上屏后编辑器光标失焦、光标不可见无法续打的问题。
• 新增：鼠标悬停在顶部分类标签上即自动预览该分类内容（无需点击）。