← Blog

Introducing AI Assist: explain, beautify and transform any selection in the editor

Select any text in the Markdown Tidy editor and let AI explain it, polish it, or apply a custom instruction — inserted on a new line, never overwriting your work.

From cleaning to editing

Markdown Tidy started as a one-shot tool: paste messy Markdown, get a polished document, export it. That covers the moment you arrive with text in hand. But editing rarely stops there. You read a paragraph back and it's clunky. A table needs a sentence of context. A reviewer asks "what does this actually mean?" Until now, that meant copying the passage out to another tab, prompting a chatbot, and pasting the result back.

AI Assist closes that loop. Select any text in the editor and three actions appear right next to it: Explain, Beautify, and Apply. The result lands in your document on a new line - your original selection is never touched.

Three actions, one selection

Explain turns a selection into a short, plain explanation, inserted as a labelled blockquote:

> **Explanation:** This clause caps liability at the fees paid in the
> prior 12 months — a standard limit, not an unusual one.

Good for dense passages, unfamiliar code, legal or contractual language, or anything a teammate might stumble over.

Beautify rewrites the selection for clarity, grammar, flow and Markdown formatting - while keeping your meaning, language and voice. It's the "make this read better" button for the sentence you just can't get right.

Apply is the freeform one. Select some text, type an instruction - "turn this into a bulleted list", "translate to Spanish", "make it more formal", "add a one-line summary" - and AI applies it to the selection.

Your text is never overwritten

This is the design decision we care about most. AI Assist always inserts its output on a new line after your selection. It never replaces what you wrote.

That means you stay in control: read the suggestion, keep it, tweak it, or delete it. There's no "accept/reject" modal to fight with and no risk of an AI rewrite quietly clobbering a paragraph you liked. You decide what stays.

And because everything you insert flows through the same regression-tested conversion pipeline that powers the rest of Markdown Tidy, anything AI Assist adds exports byte-for-byte identically to PDF, DOCX, HTML or PNG - no surprises between the editor and the file you send.

How it works

Select text in the editor's source pane and a small floating bar appears, anchored to your selection. Click an action; for Apply, type your instruction and hit Enter. A couple of seconds later the result appears below your selection.

Under the hood, your selection is sent to a model and treated strictly as data, not as instructions - so a document that happens to contain "ignore previous instructions" is just text to be explained, never a command. The output is inserted as content and never executed, which keeps the blast radius small. Explain and Beautify run on a fast, efficient model; Apply uses a stronger model for instruction-following, since that's where reasoning matters most.

Credits and access

AI Assist is part of your existing account and runs on the same credits as everything else. Explain and Beautify are billed by size - a credit per ~500 tokens, minimum one credit per call - so short selections cost a single credit. Apply is a flat 3 credits per call, and if the model fails you aren't charged.

A free account gets 50 credits a month, enough to try AI Assist properly with no card required. Premium ($5/month) includes 2,000 credits a month, and you can top up with credit packs ($5 per 5,000, non-expiring) whenever you need more. Failed calls never consume credits.

You'll need to be signed in to use it - it lives inside the editor, so there's nothing new to configure.

Try it

  1. Open a document in the editor.
  2. Select a sentence, a paragraph, or a block of code.
  3. Click Explain, Beautify, or Apply - and type an instruction for Apply.
  4. Keep what you like; the original is still right there.

This is v1, and it's deliberately focused: inline, selection-level, non-destructive. We're already looking at streaming results into the preview as they generate, and we'd love to hear what you'd reach for next - support@sudzy.co.

Related reading: The AI-generated Markdown cleanup checklist · Why ChatGPT Markdown breaks in Google Docs · Introducing the Markdown Tidy API

Try Markdown Tidy free

Paste markdown, get a polished document — no signup required.