大家公司技术文档都是拿什么写啊

[ThomasChan]

rt ，最近我们公司来了个在国企工作过的 tech leader ，带来了文档编写规范一系列改革.....，其中要求技术文档落地到 word ，放 svn 上去.....

mac 上编写 word 感觉好痛苦啊..... 而且对 word 也不熟....

[Hant]

Pages 不能用吗

[zhaojames077]

文档用 markdown 写，用 mkdocs 做展示；文档传到 GitLab ，通过 git hook 自动更新 mkdocs 文档目录。

[kxxoling]

Sphinx + ReadTheDocs

[konakona]

markdown （对技术）+wiki(对普通）

[exch4nge]

正式点的技术文档，如什么需求分析、概设、详设之类的，用 word ；其余用啥都行，喜欢 reStructuredText 。

话说楼里好多用 word 就要跳槽的， word 怎么就遭嫌弃了，用好 word 的样式表，还是能够写出漂亮的文档的， word 也有修订之类的功能，协作起来也不错。

[xiaonengshou]

用 word 没毛病啊。

[ikaros]

word 好像不是纯文本吧? SVN 能追踪改动?

[ThomasChan]

@ikaros 二进制，并不能追踪，目的可能是为了公司审计用...

[A07de21s]

用 MarkDown

[BlueMeow]

@ikaros 可以用外置工具提取字符串的，这样就可以做 diff 了

[mengzc]

公司如果有内部在线的技术文档平台那用 MD 写是不错的，不然技术文档 word 或者 pdf 格式还是最佳的，便于发送和阅读，尤其是对图片的支持，产品的技术手册图文并茂是必须的。

[balabalaguguji]

推荐你试下易文档，我用过最好的一个： https://easydoc.top