# Obsidian Migration Deep Dive

> Execute major Obsidian plugin rewrites and migration strategies. Use when migrating to or from Obsidian, performing major plugin rewrites, or re-platforming existing note systems to Obsidian. Trigger with phrases like "migrate to obsidian", "obsidian migration", "convert notes to obsidian", "obsidian replatform".

- Skill: `micsapp/obsidian-migration-deep-dive` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add micsapp/obsidian-migration-deep-dive`
- Raw SKILL.md: https://api.skillmd.com/api/skills/micsapp/obsidian-migration-deep-dive/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: micsapp (https://skillmd.com/u/micsapp)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/micsapp/obsidian-migration-deep-dive

---

# Obsidian Migration Deep Dive

## Overview
Comprehensive guide for migrating to Obsidian from other note-taking apps, or performing major plugin architecture rewrites.

## Prerequisites
- Source data access
- Understanding of Obsidian vault structure
- Node.js for scripted migrations
- Backup of source data

## Instructions

### Step 1: Pre-Migration Assessment

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

## Output
- Pre-migration assessment
- Format converters for common apps
- Link migration and fixing
- Batch migration scripts
- Migration reports

## Error Handling
| Issue | Cause | Solution |
|-------|-------|----------|
| Encoding errors | Non-UTF8 content | Detect and convert encoding |
| Broken links | Renamed/deleted files | Generate orphaned links report |
| Missing attachments | Export incomplete | Re-export with attachments |
| Duplicate files | Same name different folders | Add path prefix |

## Resources
- [Obsidian Import/Export](https://help.obsidian.md/import)
- [Evernote Export Format](https://evernote.com/blog/how-evernotes-xml-export-format-works)
- [Notion Export](https://www.notion.so/help/export-your-content)

## Next Steps
1. Review migrated content
2. Check orphaned links report

## Examples

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

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