swarnam-obsidian/README.md

1.2 KiB

Obsidian Sample Plugin

This is a sample plugin for Obsidian (https://obsidian.md).

This project uses Typescript to provide type checking and documentation. The repo contains the latest plugin API (obsidian.d.ts) in Typescript Definition format, which contains JSDoc comments describing what it does.

How to use

  • Clone this repo.
  • npm i or yarn to install dependencies
  • npm run dev to start compilation in watch mode.

How to install the plugin

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

Plugin structure

manifest.json

  • id the ID of your plugin.
  • name the display name of your plugin.
  • description the long description of your plugin.
  • isDesktopOnly whether your plugin uses NodeJS or Electron APIs.
  • js (optional) an alternative js entry point. Defaults to main.js
  • css (optional) a css file that should be injected. Defaults to styles.css

main.js

  • This is the main entry point of your plugin.
  • Import any Obsidian API using require('obsidian')
  • Import NodeJS or Electron API using require('fs') or require('electron')
  • Must export a default class which extends CustomPlugin