{"id":"6a67efc273037bd2e703691b","title":"2026 07 28 Visual Editing Replaces Markdown Authoring","path":"how-to/technical-articles/2026-07-28-visual-editing-replaces-markdown-authoring","contentMarkdown":"# 28-Jul-2026 — Visual editing replaces markdown authoring\n\n_____\n\n## The change in one sentence\n\nYou edit website text with a **visual (WYSIWYG) editor**. You no longer write markdown codes to change the site.\n\n## What members and content editors experience\n\nWhen you turn on **site edit** (or edit a walk description, group event description, or help block), you get TipTap: type normally, use the toolbar for headings, lists, links, tables and colour, and save. What you see while editing is what visitors get on the public page.\n\nThere is **no Edit/view toggle** for each field. Site edit means the visual editor; leaving site edit means the normal public page.\n\nOn busy pages (for example contact-us), the formatting toolbar only appears when you click into a field, so the page stays calm until you are actually changing something.\n\n## Before and after\n\nNot every group site has the new editor yet. **EKWG is still on the previous markdown editor**, so you can open [ekwg.co.uk/contact-us](https://www.ekwg.co.uk/contact-us), turn on site edit, and see the old workflow for real. The first two screenshots below are from that live site. The last two show the new TipTap experience on the NGX Ramblers staging site ([ngx-ramblers.org.uk](https://www.ngx-ramblers.org.uk)).\n\n![](https://ngx-ramblers.org.uk/api/aws/s3/site-content/8c220007-806f-43a6-9a75-46d5341d0cae.png)\n\n*Still live on EKWG today: turn on site edit for contact-us and every text column gets its own Edit button. On a committee page that means a lot of green chrome before you have changed a single word.*\n\n![](https://ngx-ramblers.org.uk/api/aws/s3/site-content/fc901147-df4b-49af-b4ef-f71436886aed.png)\n\n*Still live on EKWG today: click Edit and you type markdown codes (# for a heading,
for a line break) in a raw text box. The toolbar is for inserting those codes, not for seeing the finished look.*\n\n![](https://ngx-ramblers.org.uk/api/aws/s3/site-content/a471c854-f553-4a7b-aa15-de6ee0278412.png)\n\n*New visual editor on the NGX Ramblers staging site: same contact-us pattern in site edit. No per-field Edit/view toggle. The heading already looks like a heading; the formatting toolbar stays out of the way until you click into a field.*\n\n![](https://ngx-ramblers.org.uk/api/aws/s3/site-content/dc8b7de0-e303-4924-98c4-cee149cfac9f.png)\n\n*New visual editor on staging: click a field and the toolbar appears (bold, headings, lists, links, tables, colour). What you see while editing is what visitors get.*\n\n## Where markdown still exists\n\n**This change is only about how people edit pages in the browser.** It does not change the Content Export API, storage format, or machine-readable outputs.\n\nContent is still stored as markdown text. The public API still serves markdown exactly as before, for example:\n\n- `GET /api/public/content/path/?format=markdown`\n- page URLs with `?format=markdown`\n- `Accept: text/markdown`\n\nThose endpoints, response media type (`text/markdown`), and JSON fields such as `contentMarkdown` are **unchanged** and remain required for AI, crawlers, and integrations.\n\n**Site authors** do not need to learn or type that format in the UI. The visual editor and the site handle conversion for them.\n\n### Pasting\n\nIf you already have markdown (from a doc, an old page, or a technical export) and you paste it into the visual editor, TipTap turns it into normal formatted content. That is the only everyday moment markdown still “matters” — and even then you do not have to understand the syntax; paste and continue editing visually.\n\n## What this is not\n\n- We have **not** removed markdown as a storage or interchange format.\n- The Content Export API markdown format is **fully retained** and must not be treated as optional or deprecated.\n- Public pages still render stored content for visitors (via the same pipeline as before).\n- Migration and export tools still use markdown for technical reasons; **only the site-authoring UI** is visual.\n\n## Practical tips\n\n1. Click into a text field to edit; click away when finished.\n2. Use the toolbar for structure and links — no codes to memorise.\n3. Image-only columns stay as images until you choose **add text** under column settings.\n4. If you paste messy HTML or large pastes with many images, the site may offer to split content into rows; that is optional help, not a markdown lesson.\n\n## Related product work\n\nThis continues the TipTap work started for email and walks (ref #303): one visual editor for rich text, with markdown kept as a silent interchange format rather than something non-technical people must learn.","contentHtml":"

28-Jul-2026 — Visual editing replaces markdown authoring

\n
\n

The change in one sentence

\n

You edit website text with a visual (WYSIWYG) editor. You no longer write markdown codes to change the site.

\n

What members and content editors experience

\n

When you turn on site edit (or edit a walk description, group event description, or help block), you get TipTap: type normally, use the toolbar for headings, lists, links, tables and colour, and save. What you see while editing is what visitors get on the public page.

\n

There is no Edit/view toggle for each field. Site edit means the visual editor; leaving site edit means the normal public page.

\n

On busy pages (for example contact-us), the formatting toolbar only appears when you click into a field, so the page stays calm until you are actually changing something.

\n

Before and after

\n

Not every group site has the new editor yet. EKWG is still on the previous markdown editor, so you can open ekwg.co.uk/contact-us, turn on site edit, and see the old workflow for real. The first two screenshots below are from that live site. The last two show the new TipTap experience on the NGX Ramblers staging site (ngx-ramblers.org.uk).

\n

\"\"

\n

Still live on EKWG today: turn on site edit for contact-us and every text column gets its own Edit button. On a committee page that means a lot of green chrome before you have changed a single word.

\n

\"\"

\n

Still live on EKWG today: click Edit and you type markdown codes (# for a heading,
for a line break) in a raw text box. The toolbar is for inserting those codes, not for seeing the finished look.

\n

\"\"

\n

New visual editor on the NGX Ramblers staging site: same contact-us pattern in site edit. No per-field Edit/view toggle. The heading already looks like a heading; the formatting toolbar stays out of the way until you click into a field.

\n

\"\"

\n

New visual editor on staging: click a field and the toolbar appears (bold, headings, lists, links, tables, colour). What you see while editing is what visitors get.

\n

Where markdown still exists

\n

This change is only about how people edit pages in the browser. It does not change the Content Export API, storage format, or machine-readable outputs.

\n

Content is still stored as markdown text. The public API still serves markdown exactly as before, for example:

\n\n

Those endpoints, response media type (text/markdown), and JSON fields such as contentMarkdown are unchanged and remain required for AI, crawlers, and integrations.

\n

Site authors do not need to learn or type that format in the UI. The visual editor and the site handle conversion for them.

\n

Pasting

\n

If you already have markdown (from a doc, an old page, or a technical export) and you paste it into the visual editor, TipTap turns it into normal formatted content. That is the only everyday moment markdown still “matters” — and even then you do not have to understand the syntax; paste and continue editing visually.

\n

What this is not

\n\n

Practical tips

\n
    \n
  1. Click into a text field to edit; click away when finished.
    2. \n
  2. Use the toolbar for structure and links — no codes to memorise.
    3. \n
  3. Image-only columns stay as images until you choose add text under column settings.
    4. \n
  4. If you paste messy HTML or large pastes with many images, the site may offer to split content into rows; that is optional help, not a markdown lesson.
    5. \n
\n

Related product work

\n

This continues the TipTap work started for email and walks (ref #303): one visual editor for rich text, with markdown kept as a silent interchange format rather than something non-technical people must learn.

\n"}