> ## Documentation Index
> Fetch the complete documentation index at: https://docs.synscribe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to edit an AI-generated article

> Three ways to edit a draft on Synscribe (a refiner, by hand, or an AI edit), plus Pi, each stored as a layer you can review and undo.

There are three ways to edit a draft on Synscribe, and Pi makes a fourth. Run a refiner to apply your standard edits, open the markdown editor and change it by hand, or describe a change and let AI make it surgically. Every edit is stored as its own layer on top of the original, so you can Show Changes to see exactly what moved and delete a layer to undo it. It all happens on the article's Content tab; you can also just tell Pi to edit the piece.

<iframe src="https://www.loom.com/embed/632910c361ce4c9297e12cac52b0634f" frameBorder="0" allowFullScreen style={{ width: '100%', aspectRatio: '16 / 9', borderRadius: '0.5rem' }} />

## Every edit is a layer

Worth knowing up front, because it applies to all three methods: each edit is stored as a separate layer above the Original (Applied: TLDR Summary, Applied: AI Edit, and so on). Nothing overwrites the draft. Hit Show Changes to see exactly what a layer changed, and delete a layer to reverse it.

<Frame>
  <img src="https://mintcdn.com/synscribe/XrQ0E9JXai2aVK4a/images/platform/edit-layers-show-changes.png?fit=max&auto=format&n=XrQ0E9JXai2aVK4a&q=85&s=8eff8779d4d1138312253ce1edbff2eb" alt="The layer stack with Show Changes and a delete control on the AI Edit layer" width="752" height="361" data-path="images/platform/edit-layers-show-changes.png" />
</Frame>

## 1. Run a refiner

If you've [set up refiners](/platform/set-up-refiners), apply your standard edits in one click. Run Default Refiners applies your whole default set, or pick one from Select refiner and hit Run Refiner.

<Frame>
  <img src="https://mintcdn.com/synscribe/XrQ0E9JXai2aVK4a/images/platform/edit-run-refiner.png?fit=max&auto=format&n=XrQ0E9JXai2aVK4a&q=85&s=d41d6b7fa492fc6ed1bca8bd79c82541" alt="Running a single refiner from the sidebar" width="753" height="466" data-path="images/platform/edit-run-refiner.png" />
</Frame>

## 2. Edit it by hand

Click Edit to open the editor, switch to the markdown surface, and change whatever you want (say, calling yourself "Fuzzy" instead of "Fuzzy AI").

<Frame>
  <img src="https://mintcdn.com/synscribe/XrQ0E9JXai2aVK4a/images/platform/edit-click-edit-button.png?fit=max&auto=format&n=XrQ0E9JXai2aVK4a&q=85&s=bb97976f64d7ac6586fb1a0630bbe234" alt="The Edit button on the Content tab" width="1246" height="480" data-path="images/platform/edit-click-edit-button.png" />
</Frame>

Save with Ctrl-S (or Command-S) and the change is stored as a new layer.

<Frame>
  <img src="https://mintcdn.com/synscribe/XrQ0E9JXai2aVK4a/images/platform/edit-manual-toolbar.png?fit=max&auto=format&n=XrQ0E9JXai2aVK4a&q=85&s=80ad9110cf2617cba3f4b3ef29e9012c" alt="The markdown editing toolbar" width="820" height="218" data-path="images/platform/edit-manual-toolbar.png" />
</Frame>

## 3. Describe the change for AI

In the AI Edit box, describe what you want and Apply AI Edit:

```text theme={null}
Help me replace all 'Fuzzy AI' with 'Fuzzy'
```

It makes a surgical edit across the whole article and adds it as an AI Edit layer, so you can Show Changes to review it and delete it if you change your mind.

<Frame>
  <img src="https://mintcdn.com/synscribe/XrQ0E9JXai2aVK4a/images/platform/edit-ai-edit.png?fit=max&auto=format&n=XrQ0E9JXai2aVK4a&q=85&s=714791dda75b1b74a3560586b46dc6ab" alt="The AI Edit box with an instruction and the Apply AI Edit button" width="817" height="490" data-path="images/platform/edit-ai-edit.png" />
</Frame>

## Or just ask Pi

You can also do the whole thing from a Pi chat. Tell it which article and what to change:

```text theme={null}
see the blog on [title], replace all instances of [Fuzzy AI] with just [Fuzzy]
```

Pi edits the readable text (link text, image alt text, CTA copy) and leaves URLs untouched, then reports exactly what it changed.

<Frame>
  <img src="https://mintcdn.com/synscribe/XrQ0E9JXai2aVK4a/images/platform/edit-pi-result.png?fit=max&auto=format&n=XrQ0E9JXai2aVK4a&q=85&s=cb067c00f0a3da7ec23bf792167143d9" alt="Pi replacing the brand name across the article and reporting the replacements" width="1344" height="609" data-path="images/platform/edit-pi-result.png" />
</Frame>

## What to check while editing

* Title contains the keyword, and the summary mentions the company.
* Competitor links removed, company positioned first.
* Claims are accurate. Don't ship anything you can't say (the compliance guardrail also checks this at publish).

For the full bar, see [Part 1 §1.11 Definition of Done](/theory/definition-of-done) and run the [technical SEO audit](/platform/technical-seo-audit) after.

**Back to:** [Creating blogs](/platform/creating-blogs) · **Next:** [Publish your blog](/platform/publish-your-blog) · **Related:** [Set up refiners](/platform/set-up-refiners)
