Creating Your First Page

A page is the fundamental unit of content in Quixli. It's where you write, format, and organize your ideas using a block-based editor that supports rich text, images, tables, code, embedded media, and much more. This guide walks you through the entire process of creating a page — from the initial click to configuring settings and publishing.

By the end of this article, you'll understand every option available when creating and configuring a new page, and you'll have the knowledge to make your pages look professional from the start.

Quick Start

If you just want to get writing immediately, here's the 30-second version:

1. Click "+ New Page" in the top-right corner of your dashboard, or press Cmd/Ctrl + N from anywhere in Quixli

2. Type your title where it says "Untitled" at the top of the editor

3. Start writing in the content area below. Your page auto-saves every few seconds — look for the "Saved" indicator in the header

4. Share when ready by clicking the "Share" button in the top-right corner

That's it. Everything else in this guide covers optional configuration, best practices, and advanced options.

Ways to Create a Page

Quixli provides several entry points for creating new pages, depending on where you are in the application and what you're trying to accomplish:

Choosing a Starting Point

When the page creation dialog opens, you have three options:

Blank Page

Start with a completely empty editor. This is the default and best option when you know what you want to write, or when you prefer to build your structure organically as you go.

Template

Choose from Quixli's library of pre-built templates — meeting notes, API documentation, project briefs, how-to guides, and more. Templates give you a proven structure with placeholder text that you replace with your own content. This is the fastest way to produce professional-looking documents if you're not sure how to structure your page.

Import

Paste a Markdown file or import content from another source. The editor converts Markdown headings, lists, bold/italic, links, and code blocks into their native Quixli equivalents automatically. This is useful when migrating existing documentation into Quixli.

Writing Your Content

Once your page is open in the editor, click in the content area and start typing. The editor is block-based, which means every piece of content — every paragraph, heading, image, or table — is an independent block that you can move, format, duplicate, or delete independently.

The Slash Command Menu

Type / on an empty line to open the block menu. This is the most important feature to learn, because it gives you instant access to every content type the editor supports. Type a few characters after the slash to filter — for example, /table to insert a table, /h2 for a level-2 heading, or /code for a syntax-highlighted code block.

Formatting Toolbar

Select any text to reveal the floating toolbar. It provides quick access to bold, italic, underline, strikethrough, inline code, highlight, and link formatting. You can also use standard keyboard shortcuts: Cmd/Ctrl + B for bold, Cmd/Ctrl + I for italic, Cmd/Ctrl + K for links.

Auto-Save

Quixli auto-saves your page every few seconds. You'll see a "Saved" indicator in the editor header. You never need to manually save, but Cmd/Ctrl + S works if you want to force an immediate save. During real-time collaboration, saving is handled by the collaboration server (Hocuspocus) with even higher frequency.

Configuring Your Page

Click the settings icon in the top-right corner to access page configuration. These settings control how your page appears to readers, how it's discovered via search, and who can access it.

Basic Settings

• Title: The main headline of your page. It's used in search results, browser tabs, and when sharing via link. Keep it descriptive and under 60 characters for best SEO performance

• URL Slug: The web address path for your page (auto-generated from the title). You can customize it for cleaner URLs — for example, changing my-first-page-draft-v2 to simply getting-started

• Description: A brief summary (up to 160 characters) used in search engine results, social media previews, and the page list within collections. Write this as if it's the "elevator pitch" for your page

• Tags: Keywords that help you find the page later when searching or filtering. Tags are private — they help with organization, not SEO

• Icon: An emoji or icon displayed next to the page title in navigation, search results, and collections. It makes pages visually distinctive and easier to scan

Visibility and Access

Control who can see your page:

Export Options

Export your page to share outside of Quixli:

• PDF: A formatted PDF with your content, images, and tables. Ideal for printable deliverables and offline reading

• Markdown: A .md file compatible with GitHub, static site generators, and other Markdown-based tools

• HTML: A standalone HTML file you can host anywhere or embed in existing websites

• DOCX: A Microsoft Word document for recipients who prefer Office-based workflows

Heads Up

Deleting a page moves it to the trash, where it stays for 30 days before permanent deletion. You can restore any trashed page from Settings > Trash at any time during that window.

Best Practices for Great Pages

After helping thousands of users create content, we've noticed a few patterns that consistently produce better pages:

• Start with an outline: Before writing full paragraphs, add your H2 and H3 headings first. This creates a skeleton that's easy to fill in and ensures your page has a clear, navigable structure

• Use the right heading hierarchy: H1 for the page title (only one per page), H2 for major sections, H3 for subsections. This helps with accessibility, SEO, and the automatically generated table of contents

• Break up long text: Replace walls of text with lists, tables, blockquotes, and images. Readers scan before they read — give them clear visual anchors

• Link to related pages: When you reference concepts covered in other pages, link to them. This builds a connected knowledge base and helps readers explore further

• Add a description: Even for private pages, a short description helps you find the page later through search and recognize it in lists at a glance

Pro Tip: The slash command /callout creates a highlighted callout box — perfect for warnings, tips, or important notes that should stand out from the surrounding text.

Frequently Asked Questions

Is there a limit to how long a page can be?

There's no hard limit, but for the best editing experience we recommend keeping pages under 10,000 words or 100 blocks. For longer content, split across multiple pages within a collection — this also improves the reading experience with structured navigation.

Can I undo changes after saving?

Yes. Quixli maintains full version history for every page. Go to the page menu and select "Version History" to see all saved versions with timestamps. You can preview any version and restore it with one click.

What happens if I accidentally delete a page?

Deleted pages go to the trash and remain recoverable for 30 days. Go to Settings > Trash to see all deleted pages and restore any of them. After 30 days, pages are permanently removed.

Can I move a page between collections?

Yes. Open the page menu and select "Move to Collection" to add it to a different collection. A page can belong to multiple collections simultaneously.