作者：蓝狮子
版本：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 文档时，若有想法，也可以直接在文档中写明。所有修改记录，都能查到，也有备份，不用担心文档被破坏。

• 基本 wiki 语法 熟悉 wiki 入门语法。
• 从入门到精通： wiki 闯关 学习 wiki 入门。
• 如何优雅地用 wiki 记录作业？ 这个文档内容可以参考，文档排版也可以参考。
• 作业点评的指导建议 这个文档的排版，可以参考。

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

【版本号说明】¹⁾：

• 如果文档还在完善过程中，没有正式对外发布，以 V 0.x.x 来标志。如：V0.1.0 正式文档，对外发布，就用 V1.0.0
• 如果是文档的小更新，如修正了某些错字，添加了几处说明，或做了某些小的修改。就 修改小版本好。如：从V0.1.0 到 V0.1.1
• 如果是文档稍大一些的更新，如更改了框架，某部分增加了比较多的内容，就更改中间的版本号。如：从 V0.1.0 到 V0.2.0
• 为了方便自己记忆，也方便他人查看，可以在文档末尾，增加版本更新信息。就是每一次版本升级时的时间，版本号，和更新的大体内容