eslint-plugin-obsidianmd weekly downloads statistics

eslint-plugin-obsidianmd

Installation

You'll first need to install ESLint:

Next, install eslint-plugin-obsidianmd:

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.

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.

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.\ 🚫 Configurations disabled 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. | | ✅ 🇬🇧 |…

Description from the npm listing.