Ask
121
@starschema_sy ·

Getting six years of notes out of a workspace app without losing the structure — how bad was it for you? Migration

I've decided to leave, and I have roughly 3,000 pages including a lot of nested pages, a few databases used as simple tables, and about 400 images. The export gives me markdown plus a folder of files, which sounds great until you open it and every filename has a hash on the end and every internal link points at a page ID. Has anyone done this at scale and kept the links working, or did you accept a flatter structure and move on with your life?

9 answers Share
Report

Answering anonymously — a moderator will review it first.

  • @plaintext_paz · 5mo ago · 3 replies

    Did about 5,000 pages. I accepted a flatter structure and it was the right call. Two days of scripting got the hashes off filenames and rewired most of the links, and the last 10% would have taken another week. The nested hierarchy turned out to matter far less than I thought once search was fast — in eighteen months since, I've reached those pages by navigating maybe six times.

    139
    Share
    Reply

    Answering anonymously — a moderator will review it first.

    Report
    • @grepwitch · 5mo ago

      Everyone is. A hierarchy is a thing you feel good about maintaining and almost never use to find anything.

      34
      Share
      Reply

      Answering anonymously — a moderator will review it first.

      Report
    • @starschema_sy · 5mo ago

      That's reassuring. I think I'm attached to the hierarchy mostly because I built it.

      18
      Share
      Reply

      Answering anonymously — a moderator will review it first.

      Report
  • @harlan_voss · 5mo ago · 2 replies

    The databases-used-as-tables are the part that won't survive, and you should decide now what they become. Markdown tables if they're small, CSV files sitting next to the notes if they're big. Trying to preserve the database-ness is what turns these migrations into a month.

    74
    Share
    Reply

    Answering anonymously — a moderator will review it first.

    Report
    • @starschema_sy · 5mo ago

      Most of mine are under twenty rows. Markdown tables it is, then.

      12
      Share
      Reply

      Answering anonymously — a moderator will review it first.

      Report
  • @grepwitch · 5mo ago

    Order of operations matters more than tooling. Strip hashes from filenames first, then rewrite links, then move images, then delete nothing for six months. People do it in the other order and end up with a rewrite pass pointing at files they've already renamed, which is how a two-day job becomes a two-week job.

    108
    Share
    Reply

    Answering anonymously — a moderator will review it first.

    Report
  • @venv_val · 5mo ago

    Do it a whole section at a time rather than a page at a time. Half-migrated is the worst state to be in and it's exactly where most people give up and go back.

    38
    Share
    Reply

    Answering anonymously — a moderator will review it first.

    Report
  • @seasonalpalette · 5mo ago · 2 replies

    The images are where I lost things. Check the export actually contains every attachment before you cancel the subscription, because a chunk of mine were externally hosted and the export just preserved the URL. Those went dark the day the account closed.

    56
    Share
    Reply

    Answering anonymously — a moderator will review it first.

    Report
    • @attic_server · 5mo ago

      This is the one that gets people. Keep the account alive for a month past the migration and budget the fee as part of the move.

      27
      Share
      Reply

      Answering anonymously — a moderator will review it first.

      Report