5月份，Anthropic的Claude Code负责人Thariq发了条推文，说他已经把几乎所有文档从Markdown切到了HTML，还写了篇文章解释为什么，标题叫"HTML的不合理有效性"。
16小时内4400万浏览。
不少人开始喊：HTML才是新的Markdown。
法律人看了大概是一脑袋问号：我刚搞懂Markdown，还没用顺手，现在又要学HTML？
先别慌。
Markdown对法律人到底有什么用
Markdown是一种写作格式，全是纯文本。 # 号表示标题， - 表示列表，不依赖任何软件，随便什么编辑器都能打开。这种写作格式非常容易学习，十几分钟就能学会。
和Word比，最直接的好处是：层次一眼就看出来。一份辩护意见几十页，Word里要滚动半天才找到那段。Markdown文件的大纲结构是暴露在外的—— # 一、事实部分 ， ## （一）争议焦点 ，一眼定位。
AI读Markdown也比读Word省力 。Word文件传给AI，它要先解析格式层，有时候还丢内容。Markdown是纯文本，AI直接吃，占的token也少。同样的材料，Markdown版本大概比docx少用20%到30%的上下文，意味着同一个窗口里你能塞进更多案件材料。
改起来也方便。我以前存Word，文件名自然而然就变成"辩护词-v3-修改版-最终-final2.docx"这种。 Markdown可以用git管版本，每次改动都有记录，改错了回滚起来比较简单。 不熟悉git也无所谓，哪怕只是在文件夹里放个改前和改后，纯文本的对比也比二进制的Word容易多了。
而且markdown也 非常轻量 ，一份法律材料，用markdown呈现通常也就几KB到十几KB不等，非常便于在律师团队内部分发。
还有一点，写好的Markdown可以转成Word、PDF、PPT，可以生成HTML网页，可以直接发公众号。 一 份 内容，多种用途。
HTML好是好，但要不要去学呢
回到Thariq那篇文章。他的意思不是让你去手写HTML。
他说的是：Anthropic内部的文档，越来越多是在AI sessions之间传递的，不是给人逐行编辑的。在这种场景里，HTML能做标签页、可折叠区域、侧边目录，比Markdown更适合组织复杂信息。他们内部现在把计划文档、代码评审报告都默认成HTML了。
对工程师来说这说得通，他们本来就在代码环境里工作，AI生成HTML很自然。
但法律人的日常不是这样的。你写的东西要给人看，要存档，要转成各种格式。Markdown够用，给外部客户时，可以直接进行转换，也很方便。
HTML的价值在别处： 展示。
给商业客户发一份代理思路，Word文档和HTML页面的视觉感受可能是两回事。一整页无限下拉、目录跳转、关键位置高亮，看起来像个认真做的咨询报告，而不是随便发过来的文件。在向委托人汇报案件进展的时候，这种形式上的差异是有实际意义的。
但手搓HTML是另一回事。以runoob这个学习网站为例，要想做好一个网页，需要学习大量的课程。
HTML要搭结构，CSS要排样式，JavaScript要加交互。 当年我搞过一段时间，中途放弃了好几次，不是学不进去，是投入产出比太差，而且没有审美基础的话，做出来真的很丑。
但HTML的缺点一是 比较难以改动 ，如果有一些文字错误，你又不熟悉HTML相关的语言，直接丢给AI去修改的话，会占用超长的上下文，可能为了一小部分改动就需要大动干戈。二是 比较臃肿 ，一个审美在线、内容丰富的HTML可能要几十MB，而且没办法直接发给客户，要通过部署，放到网页上。
整体上，学习成本比较高，即使有AI参与，也 会占用大量的时间和token 。
这条路，没必要通过直接学习去走，也没有必要硬走，非要把所有的文档都用HTML呈现。
只在合适的时机进行呈现，为工作起到画龙点睛的作用。
Markdown是内容，HTML是包装
法律工作的写作用Markdown来做，展示让AI来转，这是分工。
你先用Markdown把辩护意见、法律分析或进度报告写好，内容捋清楚，逻辑跑通。这是主要工作。
需要对外展示的时候，新开一个对话，把之前的上下文全清掉，只粘进去那份Markdown，告诉Claude：帮我转成干净的HTML页面，专业配色，有目录导航。
为什么要清上下文？因为在原来的窗口继续做，Claude要带着你之前所有的修改历史、纠结过的措辞、删了又加回来的段落一起处理。上下文越长，越容易跑偏。 清空，让它只做一件事，质量更高，也省token。
Markdown转PDF、转PPT也一样。Markdown是你真正在编辑的东西，其他格式都是它的输出物。
一个实际例子
我最近要给客户讲解加密资产犯罪的案件逻辑，想做成PPT形式展示。
主题是"从钱包追踪到罪名认定——刑辩律师视角下的加密资产犯罪剖析"。
先用Markdown把结构搭出来：
# 链上有罪·案解
## 从钱包追踪到罪名认定
刑辩律师视角下的加密资产犯罪剖析
代码即证据 ，链上即现场 。
#
# 01 案件背景
……
#
# 02 案件经过
……
#
# 03 法律分析
……
#
# 04 判决与启示
……
内容确认清楚了。新开对话，清掉上下文，粘进去，告诉Claude：做成全屏PPT风格的HTML展示页，键盘翻页，每页一个主题，深色配色。
几分钟，一个浏览器全屏放映的PPT就出来了。发客户一个链接，打开直接看，不需要装任何软件。
内容归你，包装归AI。
那到底学不学HTML
不用学HTML，但是有必要提高一下审美。
Thariq说的那些，是在agent loop里传递文档的场景，是工程师的日常。法律人的文档要给人看，要存档，Markdown够了。
HTML的用法，知道一个就行：写好Markdown，新对话，让AI转。
Markdown打好，这个工作流比自己去啃HTML/CSS/JavaScript实用得多。
最终决定呈现内容是否优质的，还是你的审美。