---
title: "Import markdown"
url: "/help/buuk/import-markdown"
updated: "2026-11-13T18:45:43.779Z"
---
# Import markdown

If you already have markdown files, import them instead of pasting one article at a time.

![Settings → Import content: upload markdown, paste JSON, or pick another platform. Everything imports as drafts.](/api/media/assets/e0bf364f-b17a-434e-9e5b-44c92a8593cf)

1. **Open import**
   Go to **Settings → Import content** or use the markdown import action from Articles.

2. **Upload files**
   Buuk maps folders to sections. Fenced code keeps its language. GitHub-style tables and callouts (`> [!NOTE]`) become editor blocks.

3. **Review drafts**
   Imported pages land as drafts unless you choose to publish. Check slugs and section placement before they go live.
   
   Re-importing the same files uses replace mode: matched articles are overwritten in place instead of duplicated, so a docs folder stays in sync without manual cleanup.

> [!TIP]
> Prefer one import for a whole folder over dozens of copy-paste edits. You can still rewrite in the editor afterward.