大一入学,被学长拉进编程社团。第一次开会,他扔过来一个软件:"去,下个 VS Code,以后作业交 .md 文件。"
我打开一看,满屏#、*、-。我举手:"学长,这文件是不是出 bug 了?怎么全是乱码?"
全桌笑。我脸红了。
当时我以为这是个 bug
高中三年,我用 Word 写实验报告。标题黑体二号,正文宋体小四,行距 1.5 倍——老师教的。我脑子里"写文档"就等于 Word 加格式刷。
突然让我写一堆#和星号,我想:你们程序员都这么粗暴?连格式都懒得加?
我电脑里甚至没有编辑器,只用记事本。看到的.md文件长这样:
## 实验目的 - 验证 a=F/m - 测量小车加速度标题呢?加粗呢?交上去老师不得以为我在恶搞?
后来慢慢搞明白:那些#不是乱码,是它告诉我"这里要变标题"。这套逻辑和 Word 的格式刷反过来——不是先写再排版,是边写边标结构。
逻辑一通,世界顺了。
第二年做项目才真正改变我
大一时我抗拒,作业能 Word 就 Word。大二参加项目竞赛,组里六个人合写一份文档。
开始也用 Word。六个人轮流改,第三天文件传到我电脑里,排版全乱了。每人改一处,整个样式跑偏。
更崩的是版本。微信传文件,群里飘着十几个"最终版.docx"、"最终版-真的最终.docx"、"最终版-改一下.docx"。有一次我和另一个组员同时改,合并时谁也没法把对方内容揉进去。只能手动复制粘贴,眼睛快瞎了。
那是第一次集体崩溃。
崩溃完,队长(就是当年那位学长)默默给我们装了 VS Code,把项目文档迁到 Git 仓库,要求所有人改完 .md 文件提交。
我最初抵触。但用了一周发现:这个之前觉得"丑陋"的纯文本格式,竟然比 Word 顺手。
因为格式跟着符号走,不跟着软件走。换电脑、换系统,文件长什么样一模一样。六个人各自改,提交到 Git 上自动合并,谁改了哪行清清楚楚——再也没出现过"你覆盖了我的内容"那种灾难。
那时候我才意识到:之前排斥 Markdown,不是它不好,是我被 Word 那套格式刷逻辑驯化了太多年。
怎么教给学弟学妹
现在大三,我是社团副社长。前几天纳新结束,又干起当年学长干的事——教新成员用 Markdown。
我发现新生抗拒的方式和我当年一模一样。"这个 # 号是不是 bug""为什么要用这么土的东西""我用 Word 不好吗"。
我总结了一套"教学法",不是直接讲语法,而是先让他们踩一次 Word 的坑:
第一步,找一份大文档,让三个人同时改 Word。感受合并崩溃。
第二步,再让三个人同时改同一个 .md 文件,用 Git 提交合并。看代码世界版本管理怎么工作。
第三步,等他们主动来问"那个 Git 怎么配",再回头讲 Markdown 语法。
顺序一反过来,新生抵触情绪小很多。因为他们是先遇到了问题,再来找答案,不是被强行塞工具。
回头看三年
三年下来,所有笔记、实验报告、项目文档,全是 .md 文件。Git 仓库里三千多次提交,时间线拉得很长,看着踏实。
要说 Markdown 带来的最大改变,不是写文档变快了,是养成了一个习惯:先想清楚结构,再下笔。
因为 Markdown 没有花里胡哨的格式可选,你想搞复杂排版也搞不了。所以写之前得先想——这一段放在哪个标题下、这几点并列还是递进、这段话和那段话什么关系。
这个习惯,比 Markdown 这个工具值钱。
学弟学妹问我"Markdown 到底有没有用",我现在会说:它不会让你立刻变厉害。但它会改变你组织信息的方式。这种方式一旦养成,写论文、写报告、写邮件、写规划,全用得上——甚至脑子里的思路都会跟着清晰。
所以如果你现在还是觉得.md文件是 bug,请放心——你不是笨,你只是还没被 Word 的坑教育过。等你被教育过一次,自然会回来。