Markdown
You might say
The document AI wrote is full of # signs and asterisks. What is that, and can it turn into nicely formatted text?
Write structured text with lightweight punctuationMarkdown uses simple characters for headings, lists, links, code, and emphasis. It is convenient for documentation and content stored as plain text. Different renderers support different extensions, so preview the actual output and treat embedded HTML carefully.
You can say this to an AI Agent
Restructure this README as Markdown: use headings for hierarchy, lists for steps, and fenced code blocks for copyable commands. Do not align with repeated spaces, and verify the rendered preview and every closing fence.
Markdown≠Rich-text editor
Markdown uses punctuation for headings, bold text, and lists, so you edit plain text. A rich-text editor shows formatted content directly, like a familiar document app.
When to use it
- Organize context for AI with headings, lists and code blocks# Requirements
- The home page needs a sticky navigation bar
- Use blue buttonsUse headings and lists to express requirements so AI can recognize the hierarchy. - Save structured AI output for further editingWeekend plan
· SaturdayHiking
· Rest on SundayMany chat products render Markdown-style text as headings and lists. - Write README files and project documents as versionable plain textREADME.md
# My first page
## How to run
- npm installPlain text works in many editors, making it easy to save and review over time. - Keep plain-text notes readable across editorsREADME.md
# My first page
## How to run
- npm installPlain text works in many editors, making it easy to save and review over time.
When NOT to use it
- Paste without checking Markdown support: preview first, or convert to plain text# Weekly update **completed**: home-page redesign - bug fixesThe target chat box does not parse Markdown, so # and ** appear literally.
- Convert or export separately when Word is required, keeping the original .md fileWnotes.md → Save as notes.docxConversion may change Markdown structure or escape some characters.
- Use repeated spaces or arbitrary line breaks for alignment across renderersPrice ¥199
In stock 42Markdown collapses consecutive spaces; use a table or list for layout. - Open a fenced code block without closing it, so later prose becomes code```
npm run dev
The body text below also became codeA missing closing backtick makes the following content parse as a code block.
Anatomy
# Weekend Plan
**Mountain climbing on Saturday**, start early
- Bring water and snacks
```npm run dev```
# represents the first-level title, ## represents the second-level title; the specific font size is determined by the renderer style.
Use ** to clamp the words and make them bold after rendering; * An asterisk is italic
- At the beginning, one item per line; add a number in front to form an ordered list
Three backticks, one line above and one below, and the content in the middle is displayed as equal width.
Variants
Heading
# First-level title## Second-level title
Organize chapters by content hierarchy; whether to retain only one first-level heading is determined by publishing specifications
Bold & List
**Key points**- The first item
Emphasize key points and list matters
Code Fence
```npm run dev```
Paste the command and code and display them as they are with equal width.
Link & Image
[Text](Website)
The picture has one more exclamation mark than the link
Typical use cases
Rendered GitHub README
Formatted AI response
Write a weekend plan for me
Weekend Plan
Saturday: Hiking, remember to bring water
· Rest at home on Sunday
This chat product renders Markdown style text into titles, lists and codes
Editor source and preview
Typora / VS Code preview: write symbols on the left and effects on the right
Chat without Markdown rendering
# Weekly Report **Completed this week**: Home page redesign - 3 bugs fixed
The # and ** here are not parsed
The chat box does not render Markdown → convert it to plain text first, or send a screenshot directly
Recommended tool
Web fine-tuning tool · Selector Pro
Select page elements for precise AI edits
Click a button, text, or card, note the change, then copy its exact location to AI.
Open Selector Pro website↗Quick check