ARTICLE · 1365882
一份带井号的文档:六个符号,把话说成 WorkBuddy 读得懂的样子
办公群里偶尔会转来一个后缀是 .md 的文件。图标是系统认不出的空白,双击之后还要挑一个程序才打得开。用记事本打开,满屏汉字齐齐整整,行首却立着几个不合群的记号,一个井号,两个井号,几道短横线,还有一行被竖线分开的字。没有字号,没有加粗,没有居中的标题。第一次见的人,多半以为是谁把排版弄丢了。
那些记号其实就是排版,只是把样子先收起来,把层次留在纸上。办公里的文档,样子向来由软件给定,换一台电脑、换一个版本,字体与缩进就可能走样。Markdown 反其道而行,文件里只存纯文本,标题、并列、出处全靠几个符号标出来,等到要看的时候再渲染成该有的模样。它把内容与样子分开,写的时候不必分心调格式,改稿只动文字,换谁接手都不必先摸清一套样式。
这件事到交给 AI 办文档的时候,分量就不同了。WorkBuddy 能把版式定下来,把文件转成可直接发出的 Word,也能拿一份纪要做出 PPT,却不能替人判断哪一句该立作标题,哪几条本该并列;至于哪一处得留下原文作依据,更要在写稿时先想好。符号管的是层次,分寸仍在写下它的人手里。工具接手的是版式,人交出去的是思路。
辨体:把样子收起来,把层次留下来
Markdown 的文件很小,小到用记事本就能读完。最基本的几个记号各有分工。井号管标题,一个到六个,级数依次往下;短横线把并列的条目排成一行行;星号标出该重读的那半句;竖线则用来分列成表。写的时候不必点开字体菜单,也不必担心别人机器上没有装同一款字体,因为这些符号是约定,不是哪一家软件的私有格式。同一份文件,在编辑器里是带记号的字,在浏览器里是排好版的页面,内容一字未动。
新手容易在这里卡住,以为记号只是另一种字体按钮。其实两者管的是两件事。同一句「下周起交付周期压到五天」,用两个星号夹住,说的是这句话要重读;在前面加两个井号,说的是这一句撑得起一节,下面还有内容归它管。前一种是语气,后一种是结构。分不清这一层,符号就只是把字变粗变大的花招。
有一处对照很能说明问题。把「项目进度」「人员安排」「风险与对策」三行各加一个井号,看上去整整齐齐,读起来却是三段各自为政;改成一节之下各挂几条短横线,三件事顿时有了归属。层次不是排出来的,是先想出来再标上去的。

图 1 左边是纯文本,右边是同一份文字渲染后的样子。
识符:六个记号各管一件事
常用的记号不多,六个够撑起日常办公里的大部分文档。先看管层次的 # 号。全文题用一个 #,章节用两个 ##,节内再分才用三个 ###,规矩只有一条,不跳级。#号后面留一个空格,这是渲染时认得出的前提,写漏了就只是一行普通的字。
表示列表的是短横线 -。几件事平起平坐,各占一行,前面加一道短横线;有先有后的步骤,改用 1. 与 2. 依次编号,别把并列与顺序混在一处。待办还能在方括号里留空,- [ ] 是没做,- [x] 是做完,进度一眼看得出来。
管轻重的是星号 *。两个星号**夹住一句话是加粗,中文文档里够用;一个星号是斜体*,日常少见。加粗最忌整段刷黑,一段全重便等于一段全不重,只把结论那半句标出来,读的人才知道往哪里停。
还有三处记号,用在引文、链接与表格上。> 大于号起头是引用,原定的日期与会上确认的原话,放在引用里就不会与自己的判断混作一团,还没定的口径也照此办理。[]方括号写显示的字,紧跟的()圆括号写地址,[项目排期表](./schedule.csv) 指向同一目录下的文件,本地相对路径也认。竖线分列,第二行用短横线隔开表头与内容,一张表就成形了;列与列不必在源码里对齐,渲染自会归位。
六个记号写熟不过一个下午,费神的始终是另一件事,哪句话担得起一个标题,哪几条其实是一组。工具能替人把这些符号渲染成版式,替不了这个取舍。

图 2 六个常用记号的写法,以及各自渲染出来的样子。
成篇:一份周会纪要的样子
把六个记号合到一份稿子里,最见功夫的不是符号,是先后顺序。周会纪要是办公室里最常见的一种,先把结论摆在前头,事项随后跟上,待办与出处另立两节,读的人不必在段落里找。下面这份是完整示例,可以直接抄去改。
# 产品周会纪要(11 月 16 日)## 一句话结论交付节奏按两周一批推进,**暂不新增并行任务**。## 议定事项- 客户端 2.4 版于 11 月 21 日提测- 帮助文档由内容组补齐,12 月 1 日前交付- 客服反馈的三类问题并入下轮排期> 原定 11 月 14 日提测,因联调环境占用顺延,已在会上确认。## 待办| 事项 | 负责人 | 截止 || --- | --- | --- || 更新排期表 | 项目组 | 11 月 17 日 || 补齐帮助文档 | 内容组 | 12 月 1 日 |- [ ] 把排期表发给相关同事- [x] 会上确认顺延日期依据见 [项目排期表](./schedule.csv)。这份稿子里,二级标题 ## 只有三个,各自罩得住下面的内容;议定事项用短横线 -,因为三件事彼此并列,没有先后;引用那行留着原定的日期,是为了日后有人问起顺延,能找到出处。待办用了表格,事项、负责人、截止各占一列,比挤在一段话里好查。
写完通读一遍,先看标题有没有跳级,一级下面直接接三级,读的人会以为漏了一节。再看列表,并列的与有先后的混在一起,会凭空多出一层顺序。末了核一遍引用与圆括号里的地址,原话和文件都要对得上。这三处看着琐碎,恰恰是纯文本最见真章的地方,因为它没有版式替人遮掩。
改稿也轻。把「一句话结论」换成别的判断,动的是一行字,不会牵动整页的字体与缩进;换台电脑打开,还是这几行井号与短横线。

图 3 左边是源码,右边是渲染后的样子,底下是通读时要核的三处。
交办:结构递过去,判断留在手里
稿子写好了,往下才轮到工具。在 WorkBuddy 里新建任务,可以把这份 .md 文件拖进输入框,也可以用 @ 引用它,输入框旁边还能补一段说明。官方给的创建任务建议,是把目标、输入、输出格式与约束一并写清楚。带着层次的稿子递过去,省下的正是重新解释哪句是标题、哪几条是并列的功夫;一句话任务里说不清的结构,文件里已经摆好了。
同一个文件,换一句要求,走向就不同。说根据这份会议纪要生成一个 PPT,它读的是事项与结论;说按纪要的三节生成一份正式汇报,供管理层审阅,日期与负责人照原文,不要估算进度,边界就跟着进了任务。要的是能直接发出去的正式文档,就在补充说明里点明 Word;想要 .md 也照此写明,别让工具替人选格式。哪一句算结论,哪个日期不能动,都要写稿的人先拿定主意;至于数字,明确一句不许工具替人补,边界才算立住。说清楚了,工具才有准头。
做完的成果也不必散在聊天记录里。WorkBuddy 资料库把三类载体分开,MD 管的是文字与结构,数据交给 CSV,页面呈现由 HTML 承担;官方给过一句口诀,改内容改 MD,改数据改 CSV,改样子改 HTML,三件事互不打架。这份纪要存回去,下一轮任务用「添加到任务」把它带进对话,接着写月报或做汇报,都不用从头交代背景。Agent 改 MD 时不覆盖原文,改动以待确认的修订建议列在旁边,接受之后才写入。这一层设计留着人的最后一道手,稿子是自己的,改与不改也该自己点头。
工具做的事由此清楚了。它接手的是版式与格式,读进去的是已经分好层的文字;成果存回资料库,供下一轮任务取用,源头仍是那份纯文本。纯文本里若没有层次,再能干的工具也只能替人猜。新手学 Markdown,学的其实不是六个符号,是在交给工具之前,先把一件事想清楚,再把它安放到合适的位置。

图 4 从草稿到上下文、到成品、再存回资料库,人与工具各做各的那一段。
结语:符号是给机器读的,分寸是人的
那个后缀是 .md 的文件,换一台电脑打开,还是那几行#号与短横线-。它在群里被转来转去,在资料库里被下一轮任务读走,始终是一份能改的纯文本,没有走样的字体,也没有失联的样式。样子由软件临时给,内容一直是自己的。
符号只把层次标出来。哪件事该升作标题,哪句该留成结论,都是写稿的人先掂量过的;至于那个不能动的日期,更要当场拿定。WorkBuddy 会把这份结构变成能发出去的 Word 与 PPT,也会替人存好、找回来,可把一件事想清楚,再安放到合适的位置,仍是人在纸上完成的那一步。
往后交出去的稿子,多半还是这几行朴素的符号。井号还是那个井号,底下那几行字,得是自己想明白的。
/ 作者:小明/ 从高凉出发,看见更大的世界。















































































