技能 编程开发 Evernote数据迁移深度指南

Evernote数据迁移深度指南

v20260423
evernote-migration-deep-dive
这是一款用于处理Evernote复杂数据迁移的深度指南和工具集。它全面涵盖了数据从导出(包括ENEX、Markdown、JSON)到导入(ENML)的完整流程。尤其适用于需要处理大规模、跨平台数据传输,并要求数据完整性验证和健壮错误处理的开发场景。
获取技能
278 次下载
概览

Evernote Migration Deep Dive

Current State

!npm list 2>/dev/null | head -5

Overview

Comprehensive guide for migrating data to and from Evernote, including ENEX export/import, bulk API operations, format conversions (ENML to Markdown, HTML to ENML), and data integrity verification.

Prerequisites

  • Understanding of Evernote data model (Notes, Notebooks, Tags, Resources)
  • Source/target system access credentials
  • Sufficient API quota for migration volume
  • Backup strategy in place before starting

Instructions

Step 1: Migration Planning

Assess the migration scope: count notes, notebooks, tags, and total resource size. Estimate API call count and quota consumption. Plan for rate limits (add delays between operations).

async function assessMigration(noteStore) {
  const notebooks = await noteStore.listNotebooks();
  const tags = await noteStore.listTags();
  let totalNotes = 0;

  for (const nb of notebooks) {
    const filter = new Evernote.NoteStore.NoteFilter({ notebookGuid: nb.guid });
    const spec = new Evernote.NoteStore.NotesMetadataResultSpec({});
    const result = await noteStore.findNotesMetadata(filter, 0, 1, spec);
    totalNotes += result.totalNotes;
  }

  return {
    notebooks: notebooks.length,
    tags: tags.length,
    totalNotes,
    estimatedApiCalls: totalNotes * 2 + notebooks.length + tags.length,
    estimatedTimeMinutes: Math.ceil((totalNotes * 2 * 200) / 60000) // 200ms per call
  };
}

Step 2: Export from Evernote

Export notes in three formats: ENEX (Evernote's XML format, preserves everything including resources), JSON (structured data for programmatic use), or Markdown (human-readable, loses some formatting).

async function exportToMarkdown(noteStore, noteGuid) {
  const note = await noteStore.getNote(noteGuid, true, true, false, false);
  const text = enmlToMarkdown(note.content);

  return {
    title: note.title,
    content: text,
    tags: note.tagNames || [],
    created: new Date(note.created).toISOString(),
    resources: (note.resources || []).map(r => ({
      filename: r.attributes.fileName,
      mime: r.mime,
      size: r.data.size
    }))
  };
}

Step 3: Import to Evernote

Convert source data to ENML format, create notebooks to match source structure, and bulk-create notes with rate limit handling. Verify each import by comparing note counts and content hashes.

Step 4: Migration Runner

Build a migration runner with progress tracking, checkpointing (resume from failure), and verification. Log every operation for audit trail.

For the full migration planner, ENEX parser, format converters, migration runner, and verification tools, see Implementation Guide.

Output

  • Migration assessment tool (note count, estimated time, quota needs)
  • ENEX, JSON, and Markdown exporters
  • ENML importer with format conversion
  • Migration runner with progress tracking and checkpoint/resume
  • Post-migration verification (count comparison, content hash check)

Error Handling

ErrorCauseSolution
QUOTA_REACHEDUpload quota exceeded during importWait for quota reset or upgrade account tier
RATE_LIMIT_REACHEDToo many API calls during bulk migrationIncrease delay between operations, use checkpointing
BAD_DATA_FORMATSource content not valid ENMLValidate and sanitize content before import
Lost resourcesAttachments not migratedVerify resource hashes match after migration

Resources

Examples

Export all notes to Markdown: Iterate through all notebooks, export each note as a Markdown file with frontmatter (title, tags, date), save resources to assets/ directory, preserving notebook-as-folder structure.

Import from Notion: Parse Notion export (Markdown + CSV), convert to ENML, create matching notebooks, and bulk-import with checkpoint/resume for large exports (10,000+ pages).

信息
分类 编程开发
名称 evernote-migration-deep-dive
版本 v20260423
大小 7.4KB
更新时间 2026-04-28
语言