README file from
GithubSpecial Characters Panel
A searchable, categorized panel of special characters for Obsidian. Click a symbol to copy it and insert it at the cursor. Open it as a LibreOffice-style popup (the default) or as a sidebar.
Features
- Two ways to open it: a popup modelled on LibreOffice's Special Characters dialog (default), or the compact sidebar panel. Choose in Settings → Open panel as
- Popup: font dropdown (common and fancy fonts; fonts not installed on your device are hidden), Character block dropdown (the plugin's categories plus Unicode blocks such as Basic Latin, Currency Symbols, Arrows, Mathematical Operators, Devanagari), preview with hexadecimal and decimal code, Add to Favourites, recent and favourite rows, Insert and Cancel
- Real-time search by character, name, HTML entity or Unicode code point (
rarr,2192,U+2192,right arrow) - About 590 symbols in 8 categories: Arrows, Math Symbols, Currency, Bullets & Lists, Dingbats, Accented Latin, Greek Letters, Punctuation
- Click to copy and insert into the last note you were editing
- Favourites: right-click (or long-press on touch devices) a symbol to pin it
- Recently used row
- Follows your light/dark theme
Usage
Open the panel from the sigma ribbon icon or run Open Panel from the command palette. It opens in the mode chosen in settings. Open Panel as Popup, Open Panel in Sidebar and Close Panel are also available as commands.
In the popup, click a symbol to select it, then press Insert (closes the popup) or double-click it (inserts and keeps the popup open, unless "Close panel after inserting" is on). Type a hexadecimal or decimal code in the side panel to jump to that character. Search looks across all plugin symbols and also accepts a code such as U+20B9.
The font you pick changes how symbols look in the popup. A plain note can't store a font, so the inserted character is plain text unless you turn on Wrap in font style.
Settings
- Open panel as: Popup (default) or Sidebar
- Wrap in font style (popup): insert
<span style="font-family: ...">around the symbol when a font is picked - Symbol size (small / medium / large)
- Show or hide the category tabs (sidebar), recently used row and symbol count
- Insert as character or HTML entity (for example
→) - Add a trailing space after the symbol
- Close the sidebar or popup automatically after inserting
Adding your own symbols
Create custom-symbols.json in the plugin folder (<vault>/.obsidian/plugins/special-characters-panel/) and reload the plugin. Each entry is [character, name, optionalEntityName]:
{
"My Symbols": [
["☕", "hot beverage"],
["→", "rightwards arrow", "rarr"]
]
}
Using an existing category name adds to that category.
Manual installation
Copy main.js, manifest.json and styles.css into <vault>/.obsidian/plugins/special-characters-panel/, then enable the plugin in Settings → Community plugins.
Development
The symbol data lives in symbols.json and is embedded into main.js by a build step. After editing symbols.json, run:
node build.js
License
MIT