夜雨聆风
HTML是法律人的下一场文档革命吗?
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实用得多。