eslint-plugin-obsidianmd

Installation

You'll first need to install ESLint:

npm i eslint --save-dev

Next, install eslint-plugin-obsidianmd:

npm install eslint-plugin-obsidianmd --save-dev

The plugin needs ESLint 9.19 or later, and typescript-eslint 8.70.1 or later. npm installs typescript and typescript-eslint alongside the plugin if your project does not already have them; if it pins an older typescript-eslint, upgrade it. The configuration examples below import defineConfig from eslint/config, which ESLint added in 9.22; on an older ESLint, export the array without it.

The plugin reads Obsidian's own type definitions rather than bundling a copy, so your project needs obsidian installed as well. Plugin projects generated from the sample plugin already have it:

npm install obsidian --save-dev

Without it, no-unsupported-api silently reports nothing. See that rule's docs for which obsidian versions give useful results.

Usage

Add the recommended configuration to your eslint.config.mjs. This enables all recommended rules, including ESLint core, typescript-eslint type-checked rules, and Obsidian-specific rules.

// eslint.config.mjs
import { defineConfig } from "eslint/config";
import obsidianmd from "eslint-plugin-obsidianmd";
export default defineConfig([
  ...obsidianmd.configs.recommended,
  {
    languageOptions: {
      parserOptions: {
        projectService: {
          allowDefaultProject: ["eslint.config.*"],
        },
      },
    },
    rules: {
      // example: turn off a rule from the recommended set
      "obsidianmd/sample-names": "off",
    },
  },
]);

The parserOptions block is required because the recommended config includes type-checked rules that need access to your TypeScript project. allowDefaultProject ensures files not listed in your tsconfig.json (like the ESLint config file itself) are still linted without errors. See the configuration guide for details on why this is needed and how to customize it.

Note: You do not need to separately add eslint.configs.recommended or tseslint.configs.recommended — both are already included in the recommended config.

The recommended config also lints files that are not source, matching package.json, manifest.json and LICENSE by name. Run ESLint from the project root: a lint script scoped to your sources — eslint src — never visits them, and their checks silently do nothing. See Files linted beyond your source.

For advanced usage — layering stricter typescript-eslint configs, ignoring files, disabling rules for non-plugin code, and troubleshooting common errors — see the configuration guide.

Configurations

| | Name | | :--- | :------------------------- | | ✅ | recommended | | 🇬🇧 | recommendedWithLocalesEn |

Rules

💼 Configurations enabled in.\ ⚠️ Configurations set to warn in.\ ✅ Set in the recommended configuration.\ 🇬🇧 Set in the recommendedWithLocalesEn configuration.\ 🔧 Automatically fixable by the --fix CLI option.\ 💡 Manually fixable by editor suggestions.

| Name                                          | Description | 💼 | ⚠️ | 🔧 | 💡 | | :----------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------- | :----- | :----- | :- | :- | | commands/no-command-in-command-id | Disallow using the word 'command' in a command ID. | | ✅ 🇬🇧 | | | | commands/no-command-in-command-name | Disallow using the word 'command' in a command name. | | ✅ 🇬🇧 | | | | commands/no-default-hotkeys | Discourage providing default hotkeys for commands. | | ✅ 🇬🇧 | | | | commands/no-plugin-id-in-command-id | Disallow including the plugin ID in a command ID. | | ✅ 🇬🇧 | | | | commands/no-plugin-name-in-command-name | Disallow including the plugin name in a command name. | | ✅ 🇬🇧 | | | | detach-leaves | Don't detach leaves in onunload. | ✅ 🇬🇧 | | 🔧 | | | editor-drop-paste | Require checking evt.defaultPrevented and calling evt.preventDefault() in editor-drop/editor-paste handlers. | | ✅ 🇬🇧 | | | | hardcoded-config-path | Disallow hardcoded .obsidian config paths. Use Vault#configDir instead. | | ✅ 🇬🇧 | | | | no-forbidden-elements | Disallow attachment of forbidden elements to the DOM in Obsidian plugins. | ✅ 🇬🇧 | | | | | no-global-this | Disallow global and globalThis. Use window or activeWindow for popout window compatibility. | | ✅ 🇬🇧 | 🔧 | | | no-nodejs-modules | Disallow importing Node.js built-in modules unless guarded by Platform.isDesktop | | ✅ 🇬🇧 | | | | no-plugin-as-component | Disallow anti-patterns when passing a component to MarkdownRenderer.render to prevent memory leaks. | ✅ 🇬🇧 | | | | | no-sample-code | Disallow sample code snippets from the Obsidian plugin template. | ✅ 🇬🇧 | | 🔧 | | | no-static-styles-assignment | Disallow setting styles directly on DOM elements, favoring CSS classes instead. | ✅ 🇬🇧 | | | | | no-tfile-tfolder-cast | Disallow type casting to TFile or TFolder, suggesting instanceof checks instead. | | ✅ 🇬🇧 | | | | no-unsupported-api | Disallow usage of Obsidian APIs not available in the plugin's minimum app version | ✅ 🇬🇧 | | | | | no-view-references-in-plugin | Disallow storing references to custom views directly in the plugin, which can cause memory leaks. | ✅ 🇬🇧 | | | | | object-assign | Discourage using Object.assign with two arguments | | ✅ 🇬🇧 | | | | platform | Disallow use of navigator API for OS detection | ✅ 🇬🇧 | | | | | prefer-abstract-input-suggest | Disallow Liam's frequently copied TextInputSuggest implementation in favor of the built-in AbstractInputSuggest. | | ✅ 🇬🇧 | | | | prefer-active-doc | Prefer activeDocument over document for popout window compatibility. | | ✅ 🇬🇧 | | | | prefer-create-el | Prefer Obsidian DOM helpers (createEl, createDiv, createSpan, createSvg, createFragment) over native DOM methods. | | ✅ 🇬🇧 | 🔧 | 💡 | | prefer-file-manager-trash-file | Prefer FileManager.trashFile() over Vault.trash() or Vault.delete() to respect user settings. | | ✅ 🇬🇧 | | | | prefer-get-language | Prefer Obsidian's getLanguage() over localStorage.getItem('language') and i18next-browser-languagedetector for detecting the user's language. | | ✅ 🇬🇧 | | | | prefer-instanceof | Prefer .instanceOf(T) over instanceof T for cross-window safe type checks on DOM Nodes and UIEvents. | | ✅ 🇬🇧 | 🔧 | 💡 | | prefer-window-timers | Prefer window.setTimeout() and related timer functions over bare global calls for popout window compatibility. | | ✅ 🇬🇧 | 🔧 | | | regex-lookbehind | Using lookbehinds in Regex is not supported in some iOS versions | ✅ 🇬🇧 | | | | | rule-custom-message | Allows redefining error messages from other ESLint rules that don't provide this functionality natively. | ✅ 🇬🇧 | | | | | sample-names | Rename sample plugin class names | ✅ 🇬🇧 | | | | | settings-tab/no-deprecated-display | Disallow a leftover display() method on PluginSettingTab subclasses once getSettingDefinitions() is implemented and minAppVersion is 1.13.0 or later. | | ✅ 🇬🇧 | 🔧 | | | settings-tab/no-manual-html-headings | Disallow using HTML heading elements for settings headings. | ✅ 🇬🇧 | | 🔧 | | | settings-tab/no-problematic-settings-headings | Discourage anti-patterns in settings headings. | ✅ 🇬🇧 | | 🔧 | | | settings-tab/prefer-setting-definitions | Encourage PluginSettingTab subclasses to implement getSettingDefinitions() so settings appear in Obsidian 1.13+ settings search. | | ✅ 🇬🇧 | | | | settings-tab/prefer-update-over-display | Prefer this.update() over this.display() to refresh a PluginSettingTab on Obsidian 1.13+. | | ✅ 🇬🇧 | 🔧 | | | settings-tab/require-display | Require a display() method on PluginSettingTab subclasses when minAppVersion is below 1.13.0. | | ✅ 🇬🇧 | | | | ui/sentence-case | Enforce sentence case for UI strings | | ✅ 🇬🇧 | 🔧 | | | ui/sentence-case-json | Enforce sentence case for English JSON locale strings | | 🇬🇧 | 🔧 | | | ui/sentence-case-locale-module | Enforce sentence case for English TS/JS locale module strings | | 🇬🇧 | 🔧 | | | validate-license | Validate the structure of copyright notices in LICENSE files for Obsidian plugins. | | ✅ 🇬🇧 | | | | validate-manifest | Validate the structure of manifest.json for Obsidian plugins. | | ✅ 🇬🇧 | | | | vault/iterate | Avoid iterating all files to find a file by its path | | ✅ 🇬🇧 | 🔧 | |

UI sentence case

Checks UI strings for sentence case. The rule reports warnings but doesn't change text unless you run ESLint with --fix and enable allowAutoFix.

• Included at warn level in recommended config
• Extended locale checks available via recommendedWithLocalesEn
• By default allows CamelCase words like AutoReveal
• Set enforceCamelCaseLower: true to flag CamelCase as incorrect

Usage (flat config)

// eslint.config.mjs
import { defineConfig } from "eslint/config";
import obsidianmd from "eslint-plugin-obsidianmd";
export default defineConfig([
  ...obsidianmd.configs.recommended,
  // Or include English locale files (JSON and TS/JS modules)
  // ...obsidianmd.configs.recommendedWithLocalesEn,
{
    languageOptions: {
      parserOptions: {
        projectService: {
          allowDefaultProject: ["eslint.config.*"],
        },
      },
    },
// Optional project overrides
    rules: {
      "obsidianmd/ui/sentence-case": [
        "warn",
        {
          brands: ["YourBrand"],
          acronyms: ["OK"],
          enforceCamelCaseLower: true,
        },
      ],
    },
  },
]);

Notes

• Hyphenated words: Auto-Reveal becomes auto-reveal
• Locale file patterns in recommendedWithLocalesEn: en.json, en.ts, en.js, en//

Known limitations

Sentence detection may incorrectly split on abbreviations (Dr., Inc., etc.). Use single sentences or adjust rule options when needed.