Import a single markdown page

TL;DR. Open a space, hit New page → Import markdown, pick a .md file (or paste the content). One file becomes one page. Frontmatter is read into the page’s metadata; the body is parsed to a TipTap document with callouts, tables, and code blocks intact. About a minute end-to-end.

When to use this

• You drafted a doc in your favourite markdown editor and want to publish it to the wiki.
• You found a useful README or design doc on GitHub and want it in your team’s space.
• You exported a single page from another tool and just need that one page — not a whole tree.
• You asked an LLM to write something and want it in the wiki with a real edit history.

For a folder of markdown files (or a whole vault), use the Obsidian importer — it handles directory trees, wikilinks, and attachments together.

What we import

Markdown concept	What it becomes in Raccoon Page
.md file	One page
YAML frontmatter	Page title, tags, author
ATX headings (#, ##, …)	TipTap headings with stable anchor IDs
Lists, ordered + unordered + task	Native lists, including task lists
Tables	Native tables
Fenced code blocks	Fenced code blocks (language hint preserved)
 with the image attached	Image attachment + reference
> [!note] Obsidian-style callouts	Native callouts
Inline links to URLs	Plain links
Inline math ($x^2$)	Inline math nodes

What we don’t import (yet)

• Cross-page references. A [Page](./other.md) link points at a file that isn’t in this import — it lands as plain text with the original href preserved. If you want internal resolution, use the Obsidian importer with both files in the same upload.
• Image references that aren’t attached. If your .md references ./diagram.png and you didn’t include the image, the alt text shows but the image is missing. The import warns about each unresolved reference.
• Custom frontmatter keys beyond title, tags, author, and created / updated dates. Other keys are preserved on the page but ignored by the indexer.
• MDX components and Hugo / Jekyll shortcodes. They land as plain text. We don’t run a static-site renderer.

The step-by-step

1. Open the space where you want the page to land.
2. Hit New page in the sidebar (or ⌘N).
3. Pick Import markdown from the dialog.
4. Drop the .md file, paste the content, or pick from your recent uploads. The dialog previews how it will render before you commit.
5. Hit Create. The page lands at the location you opened the dialog from. Edit history starts at this version.

Honest answers

Can I overwrite an existing page? No. The single-page importer only creates new pages. To overwrite, edit the page directly and paste the markdown into the editor — the editor accepts pasted markdown and converts it on the fly.

What happens to images that are already on the web? External ![alt](https://...) links stay as external references. Raccoon Page does not re-host them. If the source disappears, the image breaks.

Can I batch-import multiple .md files this way? Not from this dialog. For a folder of files, use the Obsidian importer — it accepts a zip or extracted folder and creates the page tree for you.

Where does the title come from if frontmatter is missing? The first H1 in the body. If there’s no H1 either, the filename (sans .md) is used.

Is this on Free? Yes. Single-page markdown import works on every plan, including Free. The page count limit on Free still applies — imported pages count toward your 100-page allowance.

Coming from somewhere else

• Import from Obsidian — for a folder of markdown files (or a whole vault). Available on Free.
• Import from Confluence — HTML / XML space export, macros translated.
• Import from Notion — workspace export, Markdown + CSV.