More in Getting started

Import Markdown files

Updated 17 November 2026

Quixli imports Markdown (.md, .markdown) and plain text (.txt). Use it to move notes, proposals or a whole knowledge base in from another tool, or to start a document from something you wrote elsewhere. Word, Google Docs and Notion files cannot be imported directly; export them to Markdown first.

There are two ways in. Import Documents on a folder creates new documents, one per file. Import document in the editor replaces the content of the document you have open with one file.

Import many files into a folder

  1. On the Documents page, open the menu of the folder you want to import into and choose Import Documents.
  2. Under Import type, pick Multiple Files (up to 100 files, 5 MB each) or ZIP Archive (up to 50 MB).
  3. Drop the files in or click to browse, then click Import. You will see how many folders and documents were created.

Each file becomes a document named after its file, without the extension. Underscores and hyphens in the name become spaces, so client_onboarding-notes.md becomes "client onboarding notes". The headings inside the file stay where they are in the document; the first one does not become the title. Rename files before you import if you want tidy titles, or rename the documents afterwards.

Importing a ZIP

With ZIP Archive, the folders inside the ZIP become subfolders of the folder you import into, and the files go into them. Before you import, the window shows the structure it found.

  • Depth. Folders go five levels deep, counting the folder you import into. If the ZIP would go deeper, the window warns you and the import is refused. Import into a folder nearer the top, or flatten the ZIP.
  • Other files. Only .md, .markdown and .txt files are imported. Images, PDFs and anything else in the ZIP are skipped, as are system files such as .DS_Store and __MACOSX folders.
  • An empty result. A ZIP with no Markdown files in it is refused with "ZIP file contains no valid markdown files".

You can only import into a folder you own. To bring files into the top level, create a folder for them first.

What will my import do?

Pick where the Markdown is going and what is in it.

Where should it go?
What are you most worried about?

Where
On the Documents page, open the menu of the folder to import into, choose Import Documents, then Multiple Files.
Limits
Up to 100 files at once, 5 MB each, as .md, .markdown or .txt.
Titles
Each file becomes a document named after the file: client_onboarding-notes.md becomes “client onboarding notes”. Rename files before importing if you want different titles.
Plan limit
On Free, Quixli checks the whole import against the document limit first. If the files do not all fit, nothing is imported.
Your content
Headings, paragraphs, bulleted, numbered and task lists, quotes, horizontal rules, tables and code blocks (with their language) all come across, along with bold, italic, strikethrough, links, inline code and highlights.

Replace one document's content

In the editor, the right rail has Import document. The Import window that opens says what it does, "Replace content with imported file": pick one .md or .markdown file of up to 5 MB and click Import. Everything in the document is replaced by the file, and the document keeps its title.

Use it on a new, empty document. On a document you have already written, the import overwrites your work. If that happens, check Document history in the right rail for an earlier version; see Version history.

What converts

  • Headings, paragraphs, bulleted, numbered and task lists, quotes and horizontal rules
  • Bold, italic, underline, strikethrough, links, inline code and highlights
  • Code blocks, keeping the language
  • Tables
  • Fenced blocks named mermaid, chart, calendar, timeline, matrixGrid or bookmark become the matching Quixli blocks

You can also paste Markdown text straight into the editor and it is converted the same way.

What does not

  • Images are not brought in. The text around them imports; add each image again in the editor. See Images, videos and embeds.
  • Front matter (a --- block of settings at the top of the file) is not read as settings. Remove it before importing.
  • Links between files stay as they were written. A link to other-note.md does not turn into a link to the imported document.

Plan limits

Every imported file is a new document, so it counts towards the Free plan's limit of 10 active documents per workspace. Quixli checks the whole import before creating anything. If the workspace has room for 2 more documents and you import 5 files, nothing is imported, and the message says how many more you can create. Import fewer files, archive documents you are not using (archived ones do not count), or upgrade. Replacing one document's content creates nothing, so it never hits the limit.

Will my plan let me do this?

Pick what you are about to do and how full the workspace is. The answer uses the same limits and messages as Quixli.

What are you about to do?
Which plan is the workspace on?
How many active documents in the workspace are there now?
How many files are you importing?

RefusedNo. The import needs room for 5 documents and there is room for 2, so none of the files are imported.

Free allows 10 active documents per workspace, counting every member’s. Archived documents are not counted. An import is checked as a whole: Quixli does not import the first 2 and skip the rest.

The message you will see

You can only create 2 more pages on your FREE plan (limit: 10). You're trying to import 5 files. Please upgrade to PRO for unlimited pages.

What you can do

  • Import 2 files or fewer at a time.
  • Archive documents you are not using. Archived documents do not count, and their links and analytics are kept.
  • Delete documents you will never need again. There is no trash, so this cannot be undone.
  • Upgrade to Pro in Settings, Plan & billing.

Common mistakes

  • Expecting the first heading as the title. Titles come from file names.
  • Importing a 101st file. Multiple Files takes up to 100 at once. Split larger sets, or put them in a ZIP.
  • Replacing a document you already wrote. Import document overwrites everything in it.
  • A ZIP that is one level too deep. Count the folder you import into as the first level.

Questions

Can I import a Word document or a Google Doc?

Not directly. Export it as Markdown from the app you wrote it in, then import the .md file.

Will my imported documents be shared or tracked?

No. Imported documents are private, like any new document, until you share them.

Some of my files did not appear. Why?

A file that cannot be converted is skipped and the rest are imported, so the count at the end can be lower than the number of files you chose. In a ZIP, check that the missing files end in .md, .markdown or .txt.

Related

  • Organise documents with folders and tags

    Find and organise documents in Quixli: search, tags, folders and subfolders, archive, and moving documents between folders or into a team.

  • Write in the editor

    How the Quixli editor works: the / menu with every block, the toolbar, Markdown shortcuts while typing, pasting from other apps, and the Elements panel.