Node

Import and export

Bring existing Markdown into Node and get pages back out.

Import Markdown files

Choose Import Markdown on the home screen, in the workspace menu at the top right, in Settings, or from the command palette. You can select several files at once.

  • Accepted extensions: .md, .mdx and .markdown.
  • Maximum size: 5 MB per file.
  • Each file becomes a page in your first workspace (the first one alphabetically).
  • The file's text is stored as it was read; only Windows line endings are converted.

Node picks the page title in this order:

  1. A title: field in the file's frontmatter.
  2. The first # Heading in the file.
  3. The file name without its extension.

If a page with that title already exists, the import is added as "Title (2)" instead of replacing it. After the import, Node opens the last page it created.

Importing a whole folder

The import dialog takes individual files and puts them all in one workspace. To keep a folder structure, copy the folders into data/pages/ yourself and choose Reload from disk.

Export a page

Open a page's menu and choose Export Markdown or Export MDX. The browser downloads the page's source exactly as stored, named after the title in lowercase with dashes (for example deployment-runbook.md).

The two formats contain the same text; only the file extension differs.

Images are not bundled with an export. The downloaded file keeps its relative links to data/pages/assets/.

Sharing a page

The Share button in the top bar copies the page's link. The link only works for someone who can reach the same Node server, so to send a page to someone else, export it instead.

Getting everything out

Your pages are already files. To move or back up all of them, copy the data/pages/ directory.

Pages from an older version of Node

Early builds of Node kept pages in the browser instead of in files. If Node finds such pages, it offers once to Migrate pages; the same option stays available under Settings → Workspace.

Migration copies each page into data/pages/ with its workspaces and folders. It never replaces a file that already exists, and it leaves the browser copy in place as a backup.

On this page