> For the complete documentation index, see [llms.txt](https://esmp-fun.gitbook.io/plugins/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://esmp-fun.gitbook.io/plugins/markdown-guide/getting-started/the-web-editor.md). # Edit in your browser Edit your pages in a web browser, with the page shown beside them exactly as players will see it. Nothing to install, and your server doesn't have to be reachable from the internet: it only ever reaches out, so it works behind a router or on shared hosting.

The editor: pages on the left, the text in the middle, the page as drawn in game on the right — Your pages on the left, the text in the middle, and the page as the game draws it on the right.

You need the `mdguide.editor` permission, which operators have. ## Step 1 - Get a link In game, run: ``` /guide edit ``` and click **Click here to open the editor** in chat.

## Step 2 - Trust your browser, once The first time you open the editor in a browser, it shows a code, and your chat shows the same code with a **\[Trust this browser]** button. If the two match, click it. That browser is remembered, so you're only asked once.

The editor showing a code to compare with the one in chat — Compare this code with the one in your chat.

The editor link, the trust button, and a warning about a second browser, in chat — Everything the editor tells you in chat, including a warning if a second browser tries the same link.

Once trusted, the editor shows a live preview drawn by your own server, the **Show in game** button opens the page on your screen, unsaved changes and all, and **Save** writes straight to your server. The preview draws items and pictures as grey boxes the size they come out; **Show in game** shows them as they are. ## Writing The editor edits the page's text itself, so nothing you didn't write ever changes. It styles the text as you type: headings are big, colours are coloured, and links and pictures are marked. **The toolbar** does the formatting for you: | | | | --------------------- | ---------------------------------------------------------------- | | **Normal text** | Turns a line into a title, a section, a small heading or a quote | | **B I U S** and `< >` | Bold, italic, underlined, struck through, and code | | **Colour** | Minecraft's colours, any colour, a fade between two, or rainbow | | **Lists** | Bullet points or numbered steps | | **Link** | Words that open a page, a website or a command | | **Item** | A picture of any item or block, found by searching for its name | | **Picture** | One of your own pictures | | **Insert** | Buttons, tables, dividers, boxes, the reader's name, and more |

The menu of text styles: normal text, title, section, small heading and quote — Each kind of heading says what it is for.

Adding a link that opens another page — A link to a page, a website or a command, without having to remember how one is written.

Searching for an item by name — Every item and block the game has a picture of, by name.

The colour picker — Minecraft's sixteen colours, any colour, or a fade between two.

The Insert menu — Everything else, in one menu.

**Type `/` on an empty line** for the same menu without leaving the keyboard.

**Suggestions come up as you type:** | Type | And pick from | | ------------------------- | --------------------------------------------- | | `item:` and a few letters | Every item and block, turned into its picture | | `](` after a link's words | Your pages | | `{{` | The reader's name and your other values | | `<` | Minecraft's colours and styles | | `> [!` | The five kinds of box |

**Mistakes show with a red wavy line**: a link to a page that doesn't exist, or an item the game has no picture of. Point at it to see why. | Key | Does | | ---------------------- | ----------------------- | | Ctrl+B, Ctrl+I, Ctrl+U | Bold, italic, underline | | Ctrl+K | Add a link | | Ctrl+S | Save | | Ctrl+Z | Undo | | Ctrl+F | Find and replace | On a Mac, use Cmd instead of Ctrl. ## Pages, the sidebar and the look **New pages** come from the **+** next to **Pages**. **Page settings**, the button at the top right of a page, sets its picture in the page list and deletes it. Both happen on your server when you save, and a deleted page can be brought back until then.

The page settings — A page's picture, its name, and deleting it.

**Sidebar**, under **Look and layout**, is the list of pages on the left of the guide. Leave it on **Fill itself in**, or pick **My own list** and drag the links into order, with titles and pictures of your own. The preview shows it beside the last page you opened.

**Style** is [style.css](/plugins/markdown-guide/look-and-layout/style.md), with a dot in front of every colour so you can see it. ## Making room Drag the bar between the text and the preview to give either one more room. Double-click it to even them up. The button at the top right picks a light or dark look, or follows your computer.

## Saving Press **Save**, or Ctrl+S. With the live link up, your server writes the changes, reloads the guide, and the editor says when it's done. Without the live link, saving gives you a short command to paste in game instead: ``` /guide apply


```

{% hint style="warning" %}
**Worth knowing**

* The link stops working after a while, and while it works, **anyone who has it can read your guide's text**.
* Only one browser can use a link. A second one is turned away and you are warned in chat, since it means the link got out.
* If someone changes a page on the server while you edit it, saving leaves that one page alone and says so. Everything else still saves.
  {% endhint %}