The wiki-to-Docusaurus migration workflow
List the URLs you're migrating (export the wiki sitemap, scrape the nav from the legacy site, or hand-curate). For each URL: open URL to Markdown, paste, Convert, save the .md into docs/<category>/<slug>.md. Add YAML frontmatter to each file (id, title, slug, sidebar_position) — Docusaurus uses these for routing, navigation order, and page titles. Wire up the structure in sidebars.js (autogenerated mode reads the file tree; explicit mode lets you order things by hand). Run npm run start; the local site appears with everything in place.
MDX support and embedded React components
Docusaurus accepts both .md and .mdx. The converted output is plain Markdown, which works in either context. If you later want to embed React components (interactive code playgrounds, custom callouts, framework-specific tabs), rename the file to .mdx and import components at the top — the rest of the file stays as Markdown. Migrating from a wiki that has PDFs attached as references? Convert those via PDF to Markdown and inline the result alongside your converted wiki pages.
Docusaurus versioning, applied to migrated content
The killer feature for technical docs. Once your initial migration is in docs/, run npm run docusaurus docs:version 1.0.0 and Docusaurus snapshots the current state into versioned_docs/version-1.0.0/. Future doc changes only affect the unversioned docs/ directory; the snapshot stays frozen. For migrated content, this means you can carry the legacy wiki's version-stamped state into Docusaurus and keep history navigable forever.