Markdown Writing

1 Write naturally

OpAgent is built around Markdown. You write plain text, and the editor renders the parts you are not actively editing as a clean preview.

This means you can keep the control of Markdown while reading the document in a more polished form.

2 Useful Markdown basics

You can start with a small set of Markdown patterns:

• # Heading for headings;
• - item for bullet lists;
• 1. item for numbered lists;
• > quote for quotes;
• code blocks for examples or snippets;
• tables for comparing options;
• images for visual material.

You do not need to memorize everything. Use the patterns you need and grow from there.

3 Editing with live preview

When your cursor is on a line or block, OpAgent keeps it editable. When you move away, the content can render as a preview.

This is useful for:

• long documents with many headings;
• notes that include lists, quotes, and tables;
• conversations saved as Markdown;
• documents you read and edit repeatedly.

4 Resizable Markdown editor width

The OpAgent Markdown editor is not locked to a fixed width. The Markdown content area has two hidden vertical handles, one on each side, for adjusting the visible content range:

• Left handle: adjusts where the Markdown content starts, which is the left boundary of the content area. Drag it left to move the content start further left and leave more space on the right.
• Right handle: adjusts the maximum width of the Markdown content area, which is the right boundary. Drag it right to widen the Markdown editor, or left to narrow it.

The handles stay hidden while you write so they do not get in the way. Reveal and drag them when you need to resize a wide table, review long code lines, or prepare content for a screenshot.

4.1 How to reveal the resize handles

The handles do not appear immediately while the text editor is focused. Use this interaction:

1. Open a Markdown file.
2. If the text cursor is blinking in the document, the editor is still focused for typing. Do not drag on the text itself.
3. Move your mouse to the side you want to adjust:
   • for the left boundary, move to the blank margin on the left side of the Markdown text;
   • for the right boundary, move to the blank margin on the right side of the Markdown text, near the current right edge of the content area.
4. Click once in that blank margin and keep the mouse there for about 1 second. This click removes text focus and reveals the handle. It does not change the Markdown content.
5. When the thin vertical highlighted line appears, move the mouse onto the line. The cursor changes to a horizontal resize cursor.
6. Hold and drag the line:
   • drag the left handle left to move the content start left, or right to move it right;
   • drag the right handle right to make the Markdown content area wider, or left to make it narrower.
7. Release the mouse. The new display width is kept. Resizing only changes the current editor layout; it does not modify the Markdown file.

If the document text is not focused, you can also skip the click: hover in the left or right blank margin for about 1 second, wait for the handle to appear, then drag it.

4.2 Common workflow: capture a full wide table

When a Markdown table is too wide for a normal screenshot, use this workflow:

1. Click outside the table so the table leaves edit mode and renders as a preview.
2. In the blank margin on the right side of the Markdown content, click and pause for about 1 second until the right handle appears.
3. Drag the right handle to the right until every table column is visible.
4. If you still need more room, reveal the left handle in the left blank margin and drag it left.
5. Capture the full table with your system screenshot tool.
6. After capturing, drag the right handle back left if you want to return to a comfortable writing width.

4.3 When to use a wider editor

• Capture full Markdown tables: if a table has too many columns, widen the editor first so the full table fits in one screenshot.
• Review long code lines or links: reduce wrapping when checking code, URLs, logs, and commands.
• Present comparison content: product comparisons, plan comparisons, pricing tables, and roadmaps can be previewed at a wider display width.
• Return to a narrow writing width: when you only need to write body text, drag the editor back to a comfortable reading width.

For a complete workflow, see Capture wide Markdown tables.

5 Use case: edit Markdown and review changes

Many tools generate a new paragraph in a chat box and leave you to copy it back into the document. OpAgent is designed for the Markdown file itself: the agent can update the text in place, and you can review the change in context before keeping it.

A typical workflow:

1. Open a Markdown file.
2. Select the paragraph you want to change, or describe the change in chat.
3. Let the agent update the Markdown source directly.
4. Review the result inside the document context.
5. Keep the parts you like and continue editing.

This is useful for notes, posts, docs, changelogs, README files, and any Markdown content that needs repeated editing and review.

For the full use case, see Review Markdown edits.

6 Use Markdown as a thinking tool

Markdown is not only for final documents. It is also good for thinking:

• write rough notes first;
• turn notes into an outline;
• ask an agent to improve the structure;
• edit the result yourself;
• keep the final version in the same file.

7 Suggested writing flow

1. Write the raw idea without polishing.
2. Ask an agent to summarize or structure it.
3. Copy useful parts into the document.
4. Rewrite in your own voice.
5. Keep a short summary at the top for future reading.