Obsidian Plugin Migration

v20260311

obsidian-upgrade-migration

A migration guide for updating Obsidian plugins to new API versions, handling deprecations, and swapping to modern event, editor, and vault patterns. Use when upgrading Obsidian releases, managing breaking changes, or refreshing manifests and dependency references.

Obsidian Migration Plugins API Upgrade Automation

Get Skill

255 downloads

Overview

Obsidian Upgrade Migration

Overview

Guide for migrating Obsidian plugins to new API versions and handling breaking changes.

Prerequisites

Existing Obsidian plugin
Understanding of current plugin code
Access to Obsidian changelog

Instructions

Step 1: Check Current Compatibility

Step 2: Common Migration: CodeMirror 5 to 6

Step 3: Settings Migration

Step 4: Event API Migration

Step 5: Vault API Changes

Step 6: Editor API Migration

Step 7: Update Dependencies

For full implementation details and code examples, load: references/implementation-guide.md

Output

Updated plugin code for new API version
Migrated settings with version tracking
Replaced deprecated event patterns
Updated editor API calls
Updated manifest and versions.json

Error Handling

Error	Cause	Solution
Property not found	API removed	Check changelog for replacement
Type errors	Type definitions changed	Update `obsidian` package
Runtime errors	API behavior changed	Add version checks
Settings lost	Migration not implemented	Add migration logic

Resources

Next Steps

For CI/CD setup, see obsidian-ci-integration.

Examples

Basic usage: Apply obsidian upgrade migration to a standard project setup with default configuration options.

Advanced scenario: Customize obsidian upgrade migration for production environments with multiple constraints and team-specific requirements.

Info

Category Development

Name obsidian-upgrade-migration

Version v20260311

Size 3.48KB

Source jeremylongshore/claude-code-plugins-plus-skills

Updated At 2026-03-12