登录
No.19核心2 条来源

Markdown

课堂投屏

一句话

Markdown 是用 #、- 这类简单符号给纯文本加格式的写法,能转换成网页或排好版的文档。

大白话

Markdown 像写便条时大家约定的记号:前面加 # 是标题,前面加 - 是清单,人直接读也看得懂,程序也能照着记号把它排成漂亮的页面。

比喻的边界

便条记号大家理解一致,Markdown 却有好几种“方言”;表格、任务清单这些写法,在一个平台能显示,换个平台可能原样露出符号。

拿去就能用

开始做

我把随手记在下面了,比较乱。帮我整理成 Markdown,用标题分成:目标、功能清单、暂时不做、验收标准。没说清楚的地方列成问题问我,不要替我编。

还差:我的想法,发给 AI 前记得换掉

出错了

我写的 Markdown 表格在编辑器里预览正常,放到网站上却显示成一堆竖线。我怀疑网站用的渲染器不支持表格语法,先帮我确认它支持哪些扩展,再决定是换写法还是开启扩展。

想做深

我想让以后每个小项目都用同一份 Markdown 需求模板,AI 每次按它来做。帮我根据我前两个项目遇到的问题设计这个模板,控制在一页以内,先给草稿让我改。

别这样说 → 这样说

别这样说

帮我写个需求文档。

这样说

我要做一个记账小程序,想先写需求再动手。帮我用 Markdown 整理成一份文档,分成:要解决什么问题、核心功能、先不做什么、怎样算做完。写完我先改,再交给你开发。

差别:说清了用途和文档结构,并把写需求和写代码分成两步。

容易误解:

误解Markdown 写出来在哪儿显示都一样。

其实是基础语法基本通用,表格、任务清单、脚注等扩展要看平台是否支持,发布前在目标平台预览一次。

展开专业理解

Markdown 源文件是纯文本,由渲染器转成 HTML 等格式显示。CommonMark 统一了标题、列表、链接、代码块等基础语法;GitHub 等平台在此基础上加了表格、任务清单、删除线等扩展。和 AI 协作时,Markdown 常用来写需求、说明文档和提示词。

来源

  1. CommonMark:Markdown Reference 核对于 2026-09-26
  2. GitHub Flavored Markdown Spec 核对于 2026-09-26