Obsidian allows developers to write community plugins to extend Obsidian's functionality.

Right now, the plugin API is in alpha status. This means any part of the API could introduce breaking changes in a future release.

For developers

For instructions on creating new plugins, see our sample plugin.

For documentation on the API, check out our plugin API repo.

After you created your plugin, you can add it to our community plugin marketplace by creating a pull request in our releases repo. Refer to the sample plugin on how to release updates for your plugin.

For users

Safe Mode

By default, Obsidian has Safe Mode turned on to protect you from potential harm. Under Safe Mode, no community plugin will run.

Please be aware that community plugins can access files on your computer, connect to the internet, and even install additional programs. To read more about plugin security, see here.

In order to install community plugins, you need to turn off Safe Mode in Settings -> Community plugin -> Safe Mode.

Discover and install community plugins

After disabling Safe Mode, you can find community plugins created by the community in Settings -> Community plugin -> Community plugins -> Browse.

On this page, you can browse plugins by popularity, or search for specific plugins. Click on a plugin to see details and instruction from the plugin author. In the details page, you can click "Install" to install a plugin.

After installing, you can then find the installed plugins under Settings -> Community plugin. They need to be enabled in order to take effect. You can also uninstall them there.

Plugin security

Thanks for trusting Obsidian with your data! It means a lot to us, and we take security very seriously. That includes community plugins too.

Due to technical reasons with our platform, we're unable to restrict plugins to a specific permission or access level. Since we offer Obsidian for free, currently we're unable to manually review each plugin.

The good news is that Obsidian has an amazing and passionate community, so we rely on community trust to ensure security of community plugins.

In general, you should be able to trust most of the popular plugins from the community. We require all community community plugins to be open sourced on GitHub. If you're working with sensitive data, we recommend you to inspect the plugin code before installing it, so that your security needs are met. You can find a link to the plugin repository on the plugin detail page.

If you find any security flaws with community plugins, contact the plugin author by adding an issue on GitHub. If you believe the plugin is malicious, contact us to get the plugin investigated and removed.

Link to this note

Contributing to Obsidian

Thanks for the interest in contributing to Obsidian!There are three major ways you can contribute:1. Financial contributionCommercial licenseIf you'd like to use Obsidian for work activities, try to let your work get you a [[Commercial license|commercial license]].Add-on servicesIf you'd like

Obsidian

What is ObsidianObsidian is a both a Markdown editor and a knowledge base app.Used in the most basic way, you can edit and preview Markdown files. But its true power lies in managing densely networked knowledge base.How do we start

Core plugins

One of the most powerful aspects of [[Obsidian]] is the ability to add new functionality via plugins. It comes with several already, and many more are in development.You can also build your own Obsidian plugin. See [[Community plugins]].Plugins can be

Ribbon

The ribbon is a space for common commands that occupies the vertical space at the very left of the interface. It’s part of the left [[Sidebar]] and is always visible, even if the left sidebar is closed.ActionsEach action is presented

Status bar

The status bar shows handy information. That include helpful information about the current file, the current vault, or the current status like time and date.Status items are added both by [[Core plugins|core plugins]] and [[community plugins]].Some items are interactive but

Loading ...