Note:: Please report any bugs you encounter by opening a new issue on GitHub.

Add icons to your Obsidian notes. Supported icon sets:

• Remix Icon - 2172 icons
• FontAwesome (Free) - 1560 icons
• Roadmap includes more icon sets

You can toggle which icon set(s) you want to display in the icon picker from within the Icons Plugin settings.

This plugin uses react-icons to render icons via a Markdown postprocessor. Inspired by obsidian-citation-plugin and based on obsidian-sample-plugin.

A demonstration video showing the icon picker and the rendered markdown.

Select any icon from the icon picker (selectively activate icon packs in the settings).

The rendered markdown will display the icons accordingly.

As this is an experimental plugin, bugs are expected to occur. Kindly open an issue in this repository and describe in detail what bug you encountered.

In order to customize the icons in order to change their color, size, etc, you should make a CSS snippet.

To do this, follow these steps:

1. Go to Settings -> Appearance -> CSS Snippets
2. Turn on the CSS Snippets option and then click the folder to navigate to it's folder.
3. Make a new file called icons.css
4. Open icons.css in your preferred text editor
5. Add the following:

   .obsidian-icon {
   	... changes go here.
   }
   

6. Go Back to Settings -> Appearance -> CSS Snippets
7. Click the reload button
8. A button with the title "icons" should appear, turn it on.

Your changes will now be applied and you can edit the file when you want.

• Clone this repo to ./your-obsidian-vault/.obsidian/plugins/
• yarn to install dependencies
• npm run dev to start compilation in watch mode.

• Update your manifest.json with your new version number, such as 1.0.1, and the minimum Obsidian version required for your latest release.
• Update your versions.json file with "new-plugin-version": "minimum-obsidian-version" so older versions of Obsidian can download an older version of your plugin that's compatible.
• Create new GitHub release using your new version number as the "Tag version". Use the exact version number, don't include a prefix v. See here for an example: https://github.com/obsidianmd/obsidian-sample-plugin/releases
• Upload the files manifest.json, main.js, styles.css as binary attachments.
• Publish the release.
• Use make release for convenience

• Copy over main.js, styles.css, manifest.json to your vault VaultFolder/.obsidian/plugins/obsidian-icons-plugin/.

See https://github.com/obsidianmd/obsidian-api