目录

如何用 wiki 写一份漂亮的文档

作者：蓝狮子
版本：V0.1.0
时间：2025.4.24
说明：看这篇文章之前，你需要了解基本的 wiki 的语法，懂得基本 wiki 操作。

wiki 很强大，有自己都有的风格。与word 上写文档相比，wiki 有一些自有的优势，如：存在线上，方便他人查看和更新，有历史备份记录等。Wiki 还有一个优点：文档可以自己生长。当你想写一份专业的文档，但没有想清楚，可以先开始，然后一点点想法更新、添加内容，这是蓝狮子常用的方式。

本文就介绍这种，如何用 wiki 写一份专业的文档。主要是介绍蓝狮子自己写 wiki 文档的经验。

一、技巧提示💡

蓝狮子用 wiki 写文档常用的一些排版技巧：

  1. 吸引人的文档标题。文档标题很重要，一个好标题吸引大家点击查看，也可以让读者了解文档的主题，还方便大家用搜索功能，搜索到相关的文档。
  2. 简洁的小标题。wiki 会根据小标题会自动生成目录。所以小标题，最好有序号，整个长度不超过 7个汉字。这样文档目录会很整齐。
  3. 版本更新记录。【非必须】。有版本号，和版本更新记录，主要是为了方便大家查看更新记录。也方便自己查看记录，会很有成就感的。本文最后有【版本号说明】
  4. 使用额外颜色。文字颜色非常有助于读者抓住重点。蓝狮子一般用最简单的<color blue> 蓝色</color> 蓝色。
  5. 相关文档链接。可以在文档中增加相关文档链接，可以返回主页，可以是其他类似说明文档链接，这样方便大家直接从这个文档查看。
  6. 增加表情符号。【非必须】。可以在文档增加表情符号🦁，会让文档显得活波，不是吗？😋wiki 默认的表情符号太少，可以查看这里有更多的表情符号。
  7. 偶尔用长横线。【非必须】。长横线可以把文档内容分割，让内容有明显的模块。用这个语法：单独一行-----。大家看看本文档最开始的作者、版本、时间、说明之后，就是一个长横线。

其他技巧：

  1. 自然增长。如果没有想好文档整体该如何写，也可以先开始，然后每天增加一点。这点很有意思的，你可以试试。若更新内容较多，可以升级版本号，写版本更新记录。
  2. 边传播边完善。当文档写到一定程度（完成主题），就可以发给其他同学阅读，以后定期更新后，再发链接给大家。
  3. 降低要求。一开始也不用做过多的优化和检查，错别字，文字不够简洁，问题都不大，多看几次，就修改了。
  4. 多人协作。其他同学查看 wiki 文档时，若有想法，也可以直接在文档中写明。所有修改记录，都能查到，也有备份，不用担心文档被破坏。

二、参考链接

三、更新记录

  1. V0.1.0 2025.4.24开始写草案。

【版本号说明】1)：

1)
蓝狮子平时使用的方式