Ascend Documentation

Appearance

Creating Your First Page ​

Learn how to create and organize pages in your workspace.

Overview ​

Pages are the foundation of your workspace. Think of them as documents that can contain rich content including text, images, code, and more. You can organize pages in a hierarchical structure, making it easy to build a knowledge base, project documentation, or personal notes.

Creating a New Page ​

Method 1: From the Pages Dashboard ​

  1. Navigate to Pages

    • Click Pages in the left sidebar
    • You'll see the Pages dashboard with your page tree

  2. Create a New Page

    • At the top, you'll see a "Create a new page" form
    • Enter a title for your page (or leave blank for "Untitled")
    • Choose a parent page from the dropdown (optional)
      • Select "Root (no parent)" for top-level pages
      • Select an existing page to nest it as a child

  3. Create & Open

    • Click Create & open
    • Your page opens immediately in edit mode
    • Focus automatically starts in the title field

Method 2: From the Page Tree ​

  1. Find the Parent Page (if creating a child page)

    • Locate the page you want to create under in the tree

  2. Use the Tree Controls

    • More options for creating from the tree will be added in future updates

Understanding Page Hierarchy ​

Pages can be organized in a tree structure:

📄 Product Documentation (root)
  📄 Getting Started (child)
    📄 Installation (child of Getting Started)
    📄 Configuration (child of Getting Started)
  📄 API Reference (child)
  📄 Tutorials (child)

Benefits of hierarchy:

  • Better organization: Group related content together
  • Clear structure: Easy to understand relationships
  • Breadcrumbs: See where you are in the hierarchy
  • Navigation: Expand/collapse sections in the tree

Page Title Best Practices ​

Good Titles ​

  • ✅ "Q4 2024 Marketing Strategy"
  • ✅ "User Authentication Setup"
  • ✅ "Meeting Notes - Dec 12, 2024"

Avoid ​

  • ❌ "Page 1" (too generic)
  • ❌ "Untitled" (confusing when you have many)
  • ❌ "asdfasdf" (not searchable)

Tips:

  • Use descriptive titles that explain the content
  • Include dates for time-sensitive content
  • Use consistent naming conventions across similar pages

What Happens After Creation ​

When you create a page:

  1. Opens Immediately: No need to find it in the tree
  2. Edit Mode Active: You can start typing right away
  3. Autosave Enabled: Your changes save automatically every 2 seconds
  4. Appears in Tree: The page is immediately visible in the sidebar
  5. Added to Recent: Shows up in your Recent pages section

Default Content ​

New pages start with:

  • Title field: Empty or the title you provided
  • One empty paragraph block: Ready for content
  • Edit mode: All editing tools available

Next Steps ​

Now that you've created a page, learn how to:

Common Questions ​

Can I change the parent of a page later? ​

Yes! You can move pages by dragging them in the tree or using the move function.

How many levels deep can I nest pages? ​

There's no hard limit, but we recommend keeping it to 3-4 levels for better navigation.

Can I create pages without a title? ​

Yes, they'll be called "Untitled" but it's better to give them meaningful names.

Do I need to save after creating? ​

No! The page is saved immediately upon creation, and all edits autosave.

Next Guide: Understanding the Page Interface