Skip to content

Commit 67c9f55

Browse files
committed
feat: better and concise live preview markdown viewer docs
1 parent 6b826e4 commit 67c9f55

2 files changed

Lines changed: 16 additions & 76 deletions

File tree

docs/07-Pro Features/05-markdown-editor.md

Lines changed: 10 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -6,12 +6,10 @@ title: Markdown Editor
66
[Upgrade to Phoenix Code Pro](https://phcode.io/pricing) to access this feature.
77
:::
88

9-
The **Markdown Editor** lets you edit Markdown files directly in the Live Preview using a rich text editor. You can format text, add images, create tables, insert links, and more -- all without writing Markdown syntax by hand. Your changes are automatically synced back to the source code.
9+
The **Markdown Editor** lets you edit Markdown files directly in the Live Preview using a rich text editor. You can format text, add images, create tables, insert links, and more, all without writing Markdown syntax by hand. Your changes are automatically synced back to the source code.
1010

1111
<!-- Add an image here showing the Markdown Editor in edit mode with the toolbar visible -->
1212

13-
---
14-
1513
## Enabling Edit Mode
1614

1715
To start editing, click the **Edit** button in the preview toolbar. The toolbar expands to show formatting options, and you can start making changes right away.
@@ -22,8 +20,6 @@ To go back to the read-only view, click **Reader** (or **Done**) in the toolbar.
2220

2321
> Pro users start in Edit Mode by default when opening Markdown files.
2422
25-
---
26-
2723
## Toolbar
2824

2925
The toolbar appears at the top of the preview when you enter Edit Mode. It gives you quick access to all the formatting and editing tools described below.
@@ -32,8 +28,6 @@ On smaller screens, some toolbar buttons collapse into dropdown menus to save sp
3228

3329
<!-- Add an image here showing the full toolbar with all formatting options visible -->
3430

35-
---
36-
3731
## Text Formatting
3832

3933
Select the text you want to format and click a formatting button, or use the keyboard shortcut. If no text is selected, the formatting applies to the word at your cursor.
@@ -48,8 +42,6 @@ You can also select text and use the **floating format bar** that appears near y
4842

4943
<!-- Add an image here showing the floating format bar appearing above selected text -->
5044

51-
---
52-
5345
## Block Types
5446

5547
Use the **block type dropdown** in the toolbar to change the type of the current block. Options include:
@@ -59,30 +51,24 @@ Use the **block type dropdown** in the toolbar to change the type of the current
5951

6052
<!-- Add an image here showing the block type dropdown with heading options -->
6153

62-
---
63-
6454
## Lists
6555

6656
The toolbar has buttons for three types of lists:
6757

68-
- **Bullet list** -- unordered list
69-
- **Numbered list** -- ordered list
70-
- **Task list** -- checklist with checkboxes
58+
- **Bullet list** - unordered list
59+
- **Numbered list** - ordered list
60+
- **Task list** - checklist with checkboxes
7161

7262
Click a list button to turn the current line into a list item, or to convert an existing list to a different type.
7363

74-
---
75-
7664
## Block Elements
7765

7866
You can insert these block-level elements from the toolbar:
7967

80-
- **Blockquote** -- a quoted block of text
81-
- **Divider** -- a horizontal line
82-
- **Code block** -- a fenced code block with an optional language picker
83-
- **Table** -- inserts a new table (see [Table Editing](#table-editing))
84-
85-
---
68+
- **Blockquote** - a quoted block of text
69+
- **Divider** - a horizontal line
70+
- **Code block** - a fenced code block with an optional language picker
71+
- **Table** - inserts a new table (see [Table Editing](#table-editing))
8672

8773
## Slash Menu
8874

@@ -106,8 +92,6 @@ You can also use standard Markdown shortcuts as you type:
10692
- ` ``` ` for code blocks
10793
- `---` for dividers
10894

109-
---
110-
11195
## Table Editing
11296

11397
When you insert a table, you can edit it directly in the preview. Click any cell to start typing in it. Use `Tab` to move to the next cell.
@@ -123,23 +107,19 @@ You can also click the **+ New row** button below the table to add a row.
123107

124108
<!-- Add an image here showing the table context menu with row and column options -->
125109

126-
---
127-
128110
## Images
129111

130112
You can add images in two ways:
131113

132-
- **From a URL**: Enter the image URL and alt text in a dialog
133-
- **Upload from your computer**: Pick an image file from your device
114+
- **From a URL** - enter the image URL and alt text in a dialog
115+
- **Upload from your computer** - pick an image file from your device
134116

135117
Both options are available from the **Image** button in the toolbar or through the [Slash Menu](#slash-menu).
136118

137119
Click an image in the editor to see a popover with **Edit** and **Delete** buttons.
138120

139121
<!-- Add an image here showing the image popover with Edit and Delete buttons -->
140122

141-
---
142-
143123
## Links
144124

145125
To add a link, select some text and click the **Link** button in the toolbar (or press `Ctrl/Cmd + K`). Enter the URL in the floating input that appears and press `Enter`.
@@ -148,16 +128,12 @@ Click an existing link to see a popover showing the URL, with options to **Edit*
148128

149129
<!-- Add an image here showing the link popover with the URL, Edit button, and Remove button -->
150130

151-
---
152-
153131
## Mermaid Diagrams
154132

155133
You can insert Mermaid diagram blocks through the toolbar or the [Slash Menu](#slash-menu). In Edit Mode, Mermaid blocks show a syntax editor where you write the diagram code, with a live preview of the rendered diagram. Click **Edit** or **Done** to toggle between the code and the preview.
156134

157135
<!-- Add an image here showing a Mermaid diagram block in edit mode with the syntax editor and rendered preview -->
158136

159-
---
160-
161137
## Keyboard Shortcuts
162138

163139
| Action | Shortcut |
@@ -172,4 +148,3 @@ You can insert Mermaid diagram blocks through the toolbar or the [Slash Menu](#s
172148
| Redo | `Ctrl/Cmd + Y` or `Ctrl/Cmd + Shift + Z` |
173149
| Search | `Ctrl/Cmd + F` |
174150
| Select All | `Ctrl/Cmd + A` |
175-

docs/08-Features/06-Live Preview/04-markdown-live-preview.md

Lines changed: 6 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -2,59 +2,24 @@
22
title: Markdown Live Preview
33
---
44

5-
When you open a Markdown file (`.md`), **Live Preview** shows a nicely formatted version of your document. As you type in the editor, the preview updates in real-time so you can see exactly how your Markdown will look.
5+
When you open a Markdown file (`.md`), **Live Preview** shows a nicely formatted version of your document with syntax-highlighted code blocks, rendered Mermaid diagrams, and more. As you type in the editor, the preview updates in real-time.
66

77
<!-- Add an image here showing a Markdown file in the editor with its rendered Live Preview side by side -->
88

9-
---
10-
119
## Scroll and Cursor Sync
1210

13-
The editor and preview stay in sync as you work. When you scroll or move your cursor in the editor, the preview follows along to show the same section. This also works the other way around -- clicking a section in the preview scrolls the editor to the matching line.
11+
The editor and preview stay in sync as you work. When you scroll or move your cursor in the editor, the preview follows along to show the same section. Clicking a section in the preview scrolls the editor to the matching line too.
1412

1513
You can turn sync on or off using the **cursor sync toggle** *(link icon)* in the preview toolbar.
1614

1715
<!-- Add an image here showing the cursor sync toggle button in the toolbar -->
1816

19-
---
20-
21-
## Search
22-
23-
Press `Ctrl/Cmd + F` to open a search bar in the preview. Type your search term and use the arrow buttons to jump between matches. The preview highlights all matching text and shows a count of results.
24-
25-
Press `Esc` or click the close button to close the search bar.
26-
27-
---
28-
29-
## Theme Toggle
30-
31-
Click the **theme toggle** button *(sun/moon icon)* in the preview toolbar to switch between light and dark themes. Your choice is remembered across sessions.
32-
33-
<!-- Add an image here showing the theme toggle button and the preview in dark theme -->
34-
35-
---
36-
37-
## Code Blocks
38-
39-
Fenced code blocks are displayed with syntax highlighting. A **Copy** button appears on each code block so you can quickly copy the code.
40-
41-
---
42-
43-
## Mermaid Diagrams
44-
45-
Mermaid diagram blocks (` ```mermaid `) are rendered as visual diagrams in the preview.
46-
47-
---
48-
49-
## Print
50-
51-
Click the **Print** button in the preview toolbar to print your rendered Markdown document.
17+
The preview toolbar also has a **theme toggle** *(sun/moon icon)* to switch between light and dark themes, a **search** bar (`Ctrl/Cmd + F`), and a **print** button.
5218

5319
> Print is not available on macOS desktop apps.
5420
55-
---
56-
57-
## Editing Markdown
21+
## Markdown Editor (Pro)
5822

59-
On **Phoenix Pro Edition**, you can edit your Markdown directly in the Live Preview using a rich text editor. See [Markdown Editor](../../Pro%20Features/markdown-editor) for details.
23+
With **Phoenix Pro**, you can go beyond just viewing. Edit your Markdown directly in the Live Preview with a full rich text editor - format text, build tables, drag in images, add links, use slash commands to insert blocks, and much more. All your changes sync back to the source code automatically.
6024

25+
[Learn more about the Markdown Editor](../../Pro%20Features/markdown-editor)

0 commit comments

Comments
 (0)