Files
lobehub/docs/usage/getting-started/page.mdx
CanisMinor 43578a9bcc 📝 docs: Polishing and improving product documentation (#12612)
* 🔖 chore(release): release version v2.1.34 [skip ci]

* 📝 docs: Polish documents

* 📝 docs: Fix typo

* 📝 docs: Update start

* 📝 docs: Fix style

* 📝 docs: Update start

* 📝 docs: Update layout

* 📝 docs: Fix typo

* 📝 docs: Fix typo

---------

Co-authored-by: lobehubbot <i@lobehub.com>
2026-03-03 16:01:41 +08:00

136 lines
5.3 KiB
Plaintext

---
title: Pages
description: >-
Co-write long-form documents with Agents — Markdown, real-time preview, and
persistent editing in one place.
tags:
- LobeHub
- Pages
- Document Writing
- Markdown
- Agent Collaboration
- Real-time Editing
---
# Pages
Pages give you a dedicated space for long-form writing — technical docs, study notes, project proposals, or blog posts. Markdown support, real-time preview, and auto-save keep you focused on content. Summon an Agent at any time to help — it doesn't just suggest; it edits directly in your document, refines structure, adds paragraphs, and polishes your writing.
## Why Use Pages?
Traditional AI chat forces you to copy-paste content between conversations, losing context each time. Pages fix that:
- **Persistent workspace** — Each document exists independently, saved permanently, ready to continue anytime
- **Shared context** — All Agents work on the same document with full page context
- **Structured content** — Full Markdown support: headings, lists, code blocks, quotes, and more
- **Flexible management** — Create, import, rename, duplicate — organize all your documents in one place
## Creating and Importing Pages
### Create a New Page
From the LobeHub main interface, go to **Pages** and click **New Page**, or use the dropdown from the new file icon. Start writing immediately — your work auto-saves, so you can close anytime and pick up later.
### Import a Markdown File
Already have a Markdown document? Import it directly. In the Pages section, click **Upload Markdown File**, select your file, and it loads into a new page for immediate editing.
### Editing Pages
Pages use Markdown — a lightweight markup language with simple symbols for formatting, so you stay focused on content. You can add an icon to your page; it appears before the title.
![Add Document Icon to Page Title](/blog/assets7caf7e0d83b8a4f3d177283bb0bc55d1.webp)
### Command Palette
Press `/` while editing to open the command palette — a quick-access tool for inserting formatting elements.
![Insert Command](/blog/assets7caf7e0d83b8a4f3d177283bb0bc55d1.webp)
## Collaborating with Agents
While editing, click the Agent icon on the right side of the editor to open the Agent panel. It slides in alongside your document so you can chat and write at the same time.
By default, the **Pages Agent** is used — optimized for document writing. Need domain-specific help? Switch to a custom Agent via the top-left corner of the panel.
### What the Pages Agent Can Do
The Agent understands your full document context and can:
- **Generate content** — Write sections, paragraphs, or entire documents from your instructions
- **Refine writing** — Edit, rewrite, or improve style on request
- **Research and expand** — Add facts, examples, or deeper explanations
- **Format and structure** — Organize content with proper headings and flow
- **Maintain consistency** — Keep voice, tone, and style aligned throughout
### Using Multiple Agents
Switch Agents in the panel to get different perspectives on the same document:
- Ask a technical writer for clarity
- Bring in a subject-matter expert for accuracy
- Use a creative writer for engaging narratives
### Managing Pages
In the page list, you can rename, duplicate, copy full content, or delete pages.
## Best Practices
**Start with structure** — Outline your document with headings first, then ask the Agent to fill sections progressively:
```markdown
# Main Title
## Introduction
## Key Points
### Point 1
### Point 2
## Conclusion
```
**Use clear instructions** — Be specific when working with the Agent:
- ❌ "Make this better"
- ✅ "Rewrite this section to be more concise and add a concrete example"
**Iterate in sections** — Rather than generating an entire document at once, have the Agent write one section, review and refine it, then move to the next. Higher quality than bulk generation.
**Leverage templates** — Duplicate successful previous documents to reuse their structure.
## Keyboard Shortcuts
| Shortcut | Action |
| -------------- | -------------------- |
| `Cmd/Ctrl + S` | Save document |
| `Cmd/Ctrl + B` | Bold |
| `Cmd/Ctrl + I` | Italic |
| `Cmd/Ctrl + K` | Insert link |
| `/` | Open command palette |
## Use Cases
- **Technical documentation** — API docs, guides, specs — with an Agent that understands code
- **Research notes** — Compile and organize research with AI-assisted summaries and expansion
- **Blog posts** — Draft, refine, and polish articles through iterative editing
- **Project proposals** — Structure proposals and let the Agent clarify your thinking
## Limitations
- **Token limits** — Very long documents may require the Agent to work in sections due to context window limits
- **Formatting consistency** — Agents may use slightly different formatting conventions; review and unify as needed
- **Fact-checking** — Always verify AI-generated facts, especially statistics and technical claims
- **Voice preservation** — For personal writing, guide the Agent explicitly on tone and style to maintain your voice
<Cards>
<Card href={'/docs/usage/getting-started/resource'} title={'Resource Library'} />
<Card href={'/docs/usage/agent/agent-team'} title={'Agent Groups'} />
<Card href={'/docs/usage/agent/artifacts'} title={'Artifacts'} />
</Cards>