Skip to content

Commit a41193c

Browse files
authored
Convert selected text, Copy block links, Work item mentions in Pages (#382)
1 parent 7f5d935 commit a41193c

File tree

1 file changed

+81
-19
lines changed

1 file changed

+81
-19
lines changed

docs/core-concepts/pages/overview.mdx

Lines changed: 81 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -32,48 +32,94 @@ Pages are turned on by default when you create a new project. If needed, you can
3232

3333
- You can easily drag and drop content blocks in Plane to rearrange them on the page. Just hover over any block, grab the **⋮⋮** icon that shows up, and drag it to where you want. Let go of it to drop the block in its new spot.
3434

35+
36+
### Format your content
37+
38+
![Static toolbar](https://media.docs.plane.so/pages/static-toolbar.webp#hero)
39+
40+
+ The static toolbar at the top of the page offers a range of styling options for your content, including basic blocks like headings and lists, and advanced blocks like images, tables, and more.
41+
42+
- Quickly adjust headings (H1-H6) to create a clear, structured hierarchy in your document.
43+
- Add emphasis with text or background colors, and style important information with bold, italic, underline, and strikethrough options for better readability.
44+
- Align your content to the left, right, or center to ensure proper layout and visual balance in your document.
45+
46+
### Markdown support
47+
48+
Plane allows you to use Markdown in Pages, making it easy to format content quickly with familiar Markdown syntax. You can create headings, lists, links, and other common formats right in your page without switching to a separate editor.
49+
50+
To use Markdown in Plane, simply type the relevant symbols (like # for headings or - for lists) directly within the page. Plane will automatically convert your Markdown into the appropriate format, helping you keep your workflow smooth and efficient.
51+
3552
<div className="tag-wrapper">
36-
### AI helper
53+
## AI helper
3754
<Tags tags={[{ name: "Pro", link: "https://plane.so/pricing", additionalClass: "pro" }]} />
3855
</div>
3956

4057
![AI helper](https://media.docs.plane.so/pages/ai-helper.webp#hero-tl)
4158

42-
Plane’s AI tools enhance content creation by helping you refine, reframe, and enrich your writing. Whether you need to paraphrase a sentence, simplify complex information, or elaborate on a topic, Pages offers quick solutions right within the editor. - Make your content more clearer or concise by rephrasing text or breaking down complex ideas. - Quickly generate summaries to highlight key points, ideal for meetings or lengthy documents. - Expand on ideas to add context, detail, or depth to your writing. - Get suggestions for clear, catchy titles.
59+
Plane’s AI tools enhance content creation by helping you refine, reframe, and enrich your writing. Whether you need to paraphrase a sentence, simplify complex information, or elaborate on a topic, Pages offers quick solutions right within the editor.
4360

44-
### Format your content
61+
- Make your content clearer or concise by rephrasing text or breaking down complex ideas.
62+
- Quickly generate summaries to highlight key points, ideal for meetings or lengthy documents.
63+
- Expand on ideas to add context, detail, or depth to your writing. - Get suggestions for clear, catchy titles.
4564

46-
![Static toolbar](https://media.docs.plane.so/pages/static-toolbar.webp#hero)
65+
<div className="tag-wrapper">
66+
## Mention work items
67+
<Tags tags={[{ name: "Business", link: "https://plane.so/pricing", additionalClass: "business" }]} />
68+
</div>
4769

48-
The static toolbar at the top of the page offers a range of styling options for your content, basic blocks like headings and lists and advanced blocks like images, tables, and more. - Quickly adjust headings (H1-H6) to create a clear, structured hierarchy in your document. - Add emphasis with text or background colors, and style important information with bold, italic, underline, and strikethrough options for better readability. - Align your content to the left, right, or center to ensure proper layout and visual balance in your document.
70+
Link directly to work items within your pages using the `@` mention feature. This creates a connection between your documentation and the actual work being tracked in your project.
4971

50-
### Markdown support
72+
![Mention work items](https://media.docs.plane.so/pages/mention-work-items.webp#hero)
5173

52-
Plane allows you to use Markdown in Pages, making it easy to format content quickly with familiar Markdown syntax. You can create headings, lists, links, and other common formats right in your page without switching to a separate editor.
74+
To mention a work item:
5375

54-
To use Markdown in Plane, simply type the relevant symbols (like # for headings or - for lists) directly within the page. Plane will automatically convert your Markdown into the appropriate format, helping you keep your workflow smooth and efficient.
76+
1. Type `@` anywhere in your page.
77+
2. Start typing the work item name or ID.
78+
3. Select the work item from the list that appears.
5579

56-
### Table of contents
80+
The list shows your most recently created work items first, making it easy to reference new work. As you type, the suggestions filter to show relevant matches based on work item titles and IDs.
5781

58-
The Table of contents panel gives you a bird's-eye view of your document's structure. Just click the panel icon on the right side of your screen to reveal all the sections and headings in your current document.
82+
![Mentioned work items](https://media.docs.plane.so/pages/mentioned-work-items.webp#hero)
5983

60-
![TOC](https://media.docs.plane.so/pages/toc-pages.webp#hero-tr)
84+
Mentioned work items appear as interactive links in your page. Clicking them takes you directly to the work item's details, making it easy to jump between documentation and tasks.
6185

62-
This feature is especially handy when you're working with longer guides - instead of scrolling through everything to find what you need, you can jump directly to any section with a single click. The table of contents automatically updates as you add or modify headings, so it always reflects your document's current structure.
86+
## Block actions
6387

64-
### Info panel
88+
![Block actions](https://media.docs.plane.so/pages/block-actions.webp#hero)
6589

66-
The Info panel is your document's dashboard, showing you all the key stats at a glance. You'll find useful metrics like word count, character count, number of paragraphs, and estimated read time - perfect for keeping track of your document's scope and helping readers know what to expect.
90+
You can perform several actions on any block within a page. Just hover over the block and click the **⋮⋮ icon** that appears.
6791

68-
![Info panel](https://media.docs.plane.so/pages/info-panel-pages.webp#hero-tr)
92+
<div className="tag-wrapper">
93+
### Copy link to block
94+
<Tags tags={[{ name: "Pro", link: "https://plane.so/pricing", additionalClass: "pro" }]} />
95+
</div>
96+
97+
Get a direct URL to this specific block. When someone opens this link, they'll jump straight to this block in the page, making it easy to reference specific sections in discussions or work items.
98+
99+
### Duplicate block
100+
Create a copy of the block to reuse content without starting from scratch.
69101

70-
The panel also displays collaboration details, including who last edited the document and when it was originally created. This makes it easy to stay on top of recent changes and track your team's contributions.
102+
### Delete block
103+
Remove the block entirely from the page.
104+
These quick actions help you manage and reference your content efficiently, especially in longer documents where you need to point teammates to specific sections.
71105

72-
### Duplicate or delete block
106+
<div className="tag-wrapper">
107+
## Convert selected text to work items
108+
<Tags tags={[{ name: "Business", link: "https://plane.so/pricing", additionalClass: "business" }]} />
109+
</div>
110+
111+
Turn any text selection in your page into a work item instantly. This feature helps you capture action items or tasks directly from your documentation without interrupting your flow.
73112

74-
![Duplicate or delete block](https://media.docs.plane.so/pages/delete-duplicate-block.webp#hero)
113+
![Convert selected text to work items](https://media.docs.plane.so/pages/convert-selected-text-to-work-items.webp#hero)
75114

76-
You can quickly delete or duplicate blocks within a page. Just hover over any block and click the **⋮⋮** icon that shows up. Deleting a block removes it entirely, while duplicating allows you to reuse content without starting from scratch.
115+
To create a work item from selected text:
116+
117+
1. Highlight the text you want to convert.
118+
2. Click **Create work item from selection** from the context menu.
119+
3. Plane creates a new work item in your project using the selected text as the title.
120+
4. The original text in your page automatically converts to a work item mention, linking back to the newly created item.
121+
122+
This seamless workflow ensures nothing gets lost in translation between planning discussions and actual task tracking. Your documentation stays connected to the work being done, and your team can easily trace where work items originated.
77123

78124
## Page actions
79125

@@ -147,6 +193,22 @@ With Plane, you can publish Pages to the web, making them accessible to anyone w
147193

148194
To publish a page, click the **Publish** button at the top right of your screen. You’ll receive a unique link to share the page.
149195

196+
## Table of contents
197+
198+
The Table of contents panel gives you a bird's-eye view of your document's structure. Just click the panel icon on the right side of your screen to reveal all the sections and headings in your current document.
199+
200+
![TOC](https://media.docs.plane.so/pages/toc-pages.webp#hero-tr)
201+
202+
This feature is especially handy when you're working with longer guides - instead of scrolling through everything to find what you need, you can jump directly to any section with a single click. The table of contents automatically updates as you add or modify headings, so it always reflects your document's current structure.
203+
204+
## Info panel
205+
206+
The Info panel is your document's dashboard, showing you all the key stats at a glance. You'll find useful metrics like word count, character count, number of paragraphs, and estimated read time - perfect for keeping track of your document's scope and helping readers know what to expect.
207+
208+
![Info panel](https://media.docs.plane.so/pages/info-panel-pages.webp#hero-tr)
209+
210+
The panel also displays collaboration details, including who last edited the document and when it was created. This makes it easy to stay on top of recent changes and track your team's contributions.
211+
150212
## Troubleshooting
151213

152214
### Page content not visible

0 commit comments

Comments
 (0)