Цю сторінку ще не перекладено.

Find your way around the editor

This page is for anyone who is new to the editor. It names each part of the screen, shows how to move and change sections, and tells you where each setting lives.

Before you start

You need nothing to follow along. Open the editor in a browser. You can write without an account (see Write without an account). Signed in, you see the parts that belong to your organization too, such as Settings and Integrations in the side bar.

The parts of the editor

The parts of the editor.

From the left edge to the right, and from the top to the bottom:

  • The side bar, down the left. It takes you anywhere: your instructions, your projects, your organization's settings and your account. The button at the top left of the header opens and closes it, or press Ctrl+B (on a Mac, ⌘B). Closed, it is a narrow strip of icons.
  • The header, across the top. It shows the open instruction: its name, where it is, what state it is in, and who has it open. Share is at its right.
  • The toolbar, under the header. On its left are Suggest changes, Undo, Redo and Discard changes. On its right are Assistant, Changes, History and, while something waits for you, Review. Each of these opens a panel at the right edge of the window.
  • The page, in the middle. It shows the instruction as Preview, as Markdown (the text it is written in), or both side by side.
  • The status bar, along the bottom. On its left it shows problems and where the draft is kept. On its right are View, Hints, Keyboard shortcuts and Syntax, which shows what you can write.

The side bar

The side bar lists these places, from the top:

  • The organization and workspace you are in. Click it to switch to another workspace or organization, or to make a new one.
  • New instruction.
  • Search: the same box as the command palette, which also finds your instructions by name.
  • Instructions, with All, Drafts, Shared with me, Starred and Trash under it.
  • Explore: instructions other people have made public, to start from.
  • Integrations, with Agents, MCP, Skills, APIs and Directories: the tools your organization's instructions can name. See Add the tools your agents may use.
  • Developer, with Apps, Domains, Single sign-on, API keys and Signing. It shows only while Developer mode is on (in Settings ▸ General).
  • Settings, with General, People, Workspaces, Deployments, Security and Billing.
  • Projects: groups of instructions, each with its folders. Create project is at the end of the list.
  • At the foot: Learn, Specification, Support and Feedback, and your name, which opens Your account.

You can use the side bar from the keyboard too: ↑ and ↓ move along it, Home and End go to its ends. On a phone, it opens over the page and closes once you choose a place.

Preview and Markdown

The editor shows your instruction as Preview: the way people read it, with rules as cards. The small switch at the bottom right of the page changes what you see.

  • With Developer mode off, which is how the editor starts, the switch has Show Markdown. It opens the Markdown beside the preview. Hide the Markdown closes it again.
  • With Developer mode on, the switch has Content (the Markdown) and Preview. Click one to show it alone. Click it again to show both side by side.

Ctrl+\ (on a Mac, ⌘\) shows or hides the preview beside the text. A phone shows one at a time. When both are open, you can drag the line between them, or focus it and use ← and →.

Edit in Preview

You don't need the Markdown for most changes. In Preview, click a paragraph, a heading, a list item, or the words or reason of a rule, and type. Press Enter or click somewhere else to keep the change. Press Esc to put the words back as they were. On a touch screen, tap to start, and use Done or Cancel under the block.

Editing in place changes words only. A new line or a format such as bold is made in the Markdown. When a change can't be made in place, the editor says so, for example "That change can't be made here without changing more than its words — make it in the Markdown".

Every change in place is one step of Undo. If you are suggesting changes, it becomes a suggestion, the same as typing would.

Open an instruction to read only

An address that ends in ?preview=true opens the instruction as a reader's view: Preview only, with nothing that edits. An icon beside the name says "Preview — read only". Take that ending off the address to edit it again.

Move and change sections

A section is a heading and everything under it, up to the next heading. When the pointer is over a section, or the caret is in one, two controls appear in the margin. On a touch screen, they stay, faint, beside each heading.

  • The handle ⠿ beside the heading. Drag it to move the whole section. A line shows where it will land, and Esc puts it back. Click the handle for its menu: Move up, Move down, Duplicate, Turn into (Section heading, Subheading or Paragraph), Ask the assistant about this section… (where the assistant is on) and Delete section. After a delete, Undo in the message brings it back.
  • The + on the line between two sections, and after the last one. It adds something at that place: New section, Must, Should, Never, Guardrail, Example, a Figure (Flowchart, Sequence, Workflow or Drawing), or a Paragraph.

From the keyboard, Alt+Shift+↑ (on a Mac, ⌥⌘↑) and Alt+Shift+↓ (on a Mac, ⌥⌘↓) move the section the caret is in.

Move a section by its handle, then duplicate it.

A rule, a guardrail, an example and a figure each have a tag in the margin too. Click it for Turn into, Details…, Duplicate, Ask the assistant about this rule… (where the assistant is on), Copy a link to it and Delete rule. On a guardrail, an example or a figure, the menu names that instead, such as Delete guardrail. Click a rule's word, such as Must, to change it to Should, Never, May and the others.

The selection menu

Select some words, and a menu appears beside them. Press Shift+F10 (on a Mac, ⇧F10) to open it from the keyboard. On a phone, it slides up from the bottom.

  • Turn into changes the block the words are in. It lists Text (Paragraph, Section heading, Subheading, List item, Quote), Rules (Must, Should, Never, May, Always, Avoid) and Blocks (Guardrail, Example, Code). The current kind has a tick.
  • Bold, Italic, Code, Link, Strikethrough and Clear formatting change how the words look.
  • Four buttons make the words a mention: Person or agent, Instruction, block or tag, Parameter, and Capability — an MCP server, a skill. The selected words start the search. See Mention people, tools and other instructions.
  • Comment on the words starts a comment. See Suggest changes and review them.
  • Where the assistant is on, its quick actions run at once: Make it a rule, Make it clearer, Make it shorter, Fix spelling and grammar, Turn it into an example and Add a guardrail for it. Ask the assistant… is a box where you say what to change. See The assistant.
The selection menu, with Turn into open.

The header

The header tells you about the open instruction at a glance.

  • The name. Click it to rename the instruction in place. Enter keeps the new name and Esc leaves it as it was. A new one is Untitled instruction until you name it.
  • The star right after the name. Add to favorites marks it, and Starred in the side bar lists your favorites.
  • Small icons beside the name, under About this instruction. Point at one to read what it says, such as "Kept in your workspace on instruction.md — saved as you type, nothing reaches agents until you publish", "Signed", "Read-only", "Suggesting" or "Sealed".
  • The version pill. Draft means it isn't published yet. v3 is the version agents follow. v3 · Edited means you have changes agents don't have yet. Click it to open History.
  • Who can read it. An icon says Private (only you, and the agents you connect), Organization (everyone in it) or Public (anyone, and listed in Explore). Click it to open Share.
  • Its classification and its labels, when it has them, such as "Classified confidential — handle with care".
  • Where it is, under the name: the workspace and the folders it is in.
  • Faces, at the right: who has it open now, and the agents that follow it. Readers don't see them.
  • Share, at the right. It has With people (Share a link…, Copy the link), As a file (Download .md), With your AI agents (Connect an agent…, Follow in your coding agent…, Deploy to…) and Make it yours (Fork — a copy of your own). A Reader sees Request access in its place. A copy you made has Offer changes beside it.

Find your way in a long instruction

  • Contents lists the headings. Click one to go there. Open it from View ▸ Contents, or press Ctrl+Shift+O (on a Mac, ⇧⌘O).
  • Go to line takes you to a line of the text. Press Ctrl+G (on a Mac, ⌃G). When line numbers or Developer mode are on, the status bar shows where the caret is, such as Ln 12, Col 4. Click it to open Go to line too.
  • Go to a rule or section lists every section and block by name. Press Ctrl+Shift+. or Ctrl+> (on a Mac, ⇧⌘. or ⌘>).
  • The command palette finds any command. Press Ctrl+K (on a Mac, ⌘K). On a phone or a tablet, use the Search button in the header.

Keyboard shortcuts and the command palette lists every key.

View options

The View button (an eye) in the status bar has the choices for how the text is shown. The editor remembers them in this browser.

Choice What it does To start with
Show or hide the side bar Opens or closes the side bar. As you left it
Contents Shows the list of headings. —
Preview beside the text Shows the preview next to the Markdown. —
Line numbers Numbers down the left edge of the text. Off
Highlight the current line Marks the line the caret is on. On
Rule numbers in the margin R1, G1 and so on beside each rule, as the preview names them. On
Monospace text Shows the Markdown in a fixed-width face, which helps with tables. Off
Suggest as you type Offers rules, blocks, parameters and mentions at the caret. On

The same choices are in Settings ▸ General, under Editor. A phone's View menu leaves out what it can't show.

Saving and checkpoints

There is no Save button. The editor saves your draft as you type. The status bar says where it is kept: In your workspace when you are signed in, or "only in this browser" when you aren't.

While you write, the editor also keeps checkpoints: after a pause, every few minutes, when you leave, and before a restore or a discard. They are in History, so you can go back to one. To keep one now, for example before a big change, press Ctrl+S (on a Mac, ⌘S) (Keep a checkpoint now in the command palette). The editor says "Kept a checkpoint — your changes are saved as you type".

Saving is not publishing. Nothing you write reaches an agent until you publish a version. See Publish, schedule and write a version message.

Document settings and details

An instruction has two parts that are for people, not for the agent. Details, at the top of the Markdown, holds its title, its version label and its parameters. Notes, at the end, holds things such as who wrote it and what changed. The editor folds both in the Markdown, and the agent never receives them. See What an instruction can say.

Document settings… in the command palette opens two choices for the whole instruction, under This document:

  • Language: the language the instruction is written in.
  • Sensitivity: Public — anyone, Internal — your organization, Confidential — named people or Restricted — the strictest. The header shows it as the classification.

The editor saves them in the instruction's Details, and Undo takes them back.

Blocks have details of their own. In Preview, click the head of a card, such as a person, an MCP server, a tool, a parameter or a workflow, and its form opens under it. Change what you need and press Done, or Cancel to leave it. Show in Markdown takes you to its text. A rule's Details… (in its tag's menu) has Only when: when the rule applies, in a few words. Left empty, the rule always applies. With Developer mode on, each form also opens Technical details.

A block's details, changed in Preview.

Install the app and work offline

You can install the editor as an app, in its own window. Use Install the app in Your account, or Settings ▸ General ▸ Install the app. It appears where your browser can install apps.

When the connection drops, the status bar shows Offline. What you type is still kept in this browser.

When instruction.md is updated, a message says "A new version of instruction.md is ready". Click Reload to use it. You don't lose anything you wrote.

The editor in your language

The editor is in English, Ukrainian, French, Spanish and Arabic. To change it, open Your account ▸ Appearance and choose a Language, or Same as my browser. The page reloads in that language. In Arabic, the whole editor reads from right to left.

The language of the editor doesn't change your instructions. They stay as you wrote them.

The editor in Arabic reads from right to left.

Where settings live

Where What is there Whose it is
Your account ▸ Profile / Security / Notifications / Appearance / Privacy / Connected apps Your name and language, your passkeys, your messages, how the editor looks, your data, and the AI apps you connected Yours
Settings ▸ General The editor's own choices in this browser, Developer mode and Install the app Yours, in this browser
Settings ▸ People / Workspaces / Deployments / Security / Billing Who is in the organization, its workspaces, where its agents run, its sign-in rules and activity, and its plan The organization's
Integrations ▸ Agents / MCP / Skills / APIs / Directories The tools and services instructions can name The organization's
Developer ▸ Apps / Domains / Single sign-on / API keys / Signing What developers set up. Shown only with Developer mode on The organization's

What you can change under Settings, Integrations and Developer depends on your role. See Invite people and choose their roles.

If it doesn't look right

What you see Why What to do
Not saved in the status bar This browser refused to store the draft, for example because it is full or in a private window. Click it to open Storage, and export what you need.
Read-only — it can't be changed here now You can read this instruction but not change it here, for example because you are a Reader. If you need to change it, use Request access in the header.
Suggesting — your edits are proposals the owner accepts You are a Contributor, or Suggest changes is on. Keep writing: a Maintainer accepts or rejects your suggestions.
Preview — read only The address ends in ?preview=true. Open it without that ending.
"This instruction was written by a newer version of instruction.md — reload to keep editing" Someone saved it with a newer editor than yours. Reload the page.
No Developer group in the side bar Developer mode is off. Turn it on in Settings ▸ General.
Still stuck Ask us at Support.

Questions

Is there a Save button?

No. The editor saves as you type, and keeps checkpoints in History. Publishing is what sends a version to agents.

Can I change an instruction without the Markdown?

Yes. Click words in Preview to edit them, use the + between sections to add, and the handles to move. A few changes, such as new lines and formats, need the Markdown.

Why can't I see the Developer group?

It shows only while Developer mode is on. Turn it on in Settings ▸ General.

Does the editor's language change my instructions?

No. It changes the editor's own words. Your instructions stay as you wrote them.

Last checked against the product:

Was this page helpful? Report a problem