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.
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
- README and documentation
- Notes and knowledge bases
- Content that needs version controlTwo columns for side-by-side comparison.
- Text with headings, links, lists, and code
When NOT to use it
- Assume every Markdown renderer behaves the same
- Use complicated tables for layout
- Insert untrusted HTML without sanitizing it
- Expect precise visual design from plain Markdown alone
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
README
Documentation
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
Blog draft
Typora / VS Code preview: write symbols on the left and effects on the right
Project notes
# 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