HN讨论 · 身份未知2026-08-24

因 LLM 输出无法“直说”，文档作者坚持人工编写 Markdown

一位 side project 作者分享自己的写作规则：代码和测试可以宽松，但 Markdown 文档必须经过删改编辑、使用人类语气，因为他认为 LLM 生成文本常带离题、重复、过度解释等缺陷，无法“直说”。他宁可自己写，以保证文本清晰，无论是人直接读还是交给 LLM 处理。

查看原始信号hn:49423182

目标用户

在 side projects 中维护 Markdown 文档、在意文本清晰度的开发者

潜在需求

希望 Markdown 文档能清晰、线性、直接地传达信息，让直接阅读或交给 LLM 处理的人都能得到准确理解；目前他只能通过人工编辑和重写来实现。

发生场景

作者在 side project 中制定文本规则：代码中的评论可以充满 LLM 风格，但 Markdown 文档必须大量删改、编辑并转为人类语气。他观察到 LLM 无法线性呈现相关事实，输出常含离题、重复、过度解释等风格问题，因此不能直接满足他对清晰文档的要求。

来源证据

作者认为 LLM 无法以线性相关事实流呈现文本，因此他编写的 Markdown 文件必须大量删改、编辑并转为人类语气。

must be heavily redacted, edited, and put into a human voice. The simple reason is that LLM's, machines built to generate text, are incapable of presenting a linear flow of relevant facts without sidebars, tangents, irrelevancies, duplication, gaps, well-known style fails like overuse of stock words and phrases, layers of historical cruft, over-explanations, and qualitative fluff. In other words, they can't tell it straight. I have only one audience, people. Some of them read the text

https://news.ycombinator.com/item?id=49423182

为什么值得留意

这是一个真实写作场景中的具体抱怨：作者认为 LLM 输出在技术文档场景下有明确质量缺陷，因而选择人工编写。该信号反映出 LLM 生成文本在文档场景中的局限，也说明人工编辑仍是保证质量的路径。

未满足部分

LLM 生成的文本在文档场景中缺乏线性事实流，需要人工删改和重写才能达到清晰标准

可能延伸 · 模型推测

（推测）可开发自动检测并剥离 LLM 文本中离题、重复、过度解释片段的编辑工具
（推测）可设计面向文档清晰的写作约束或审校提示，减小人工编辑负担

目前未知

帖子无评论或外部佐证，仅为作者个人观点
作者未说明是否尝试过提示工程或工具辅助，需求边界不明确

继续核实

其他文档维护者是否也因 LLM 输出风格问题而选择人工写作？
在技术文档场景中，哪些 LLM 风格缺陷最影响可读性？
现有编辑工具能否有效识别和移除 LLM 文本的离题与重复？

主题词

markdown documentationllm text qualitydocument editinglinear presentationtechnical writing