手把手教你搭建基于 MarkDown 的 Wiki 系统

1 准备资源

• mdwiki 基础包
• http 服务器（应用服务器也可以，之所以需要应用服务器，因为 mdwiki 必须放在 http 服务器下运行。 ）

以上资源，请先自行下载好 O(∩_∩)O~。

2 创建中文环境

mdwiki 基础包结构：

• 把项目文件夹改名为 *-wiki（当然也可以取你自己喜欢的名字喽 O(∩_∩)O ）。
• ll_CC 为模板目录，不要直接使用，这样便于以后 mdwiki 更新与升级。因此我们把 ll_CC 目录完整拷贝一份，然后把文件夹改为 zh_CN。这样我们就创建了一个中文目录环境。如果你想让你的 wiki 支持多种语言，建议参考国际语言代码表，然后复制多份 ll_CC，放置在根目录下。

3 放入 http 服务器

这里演示的环境是：

• tomcat 服务器
• idea 编辑器
• git （用于页面托管）

具体搭建服务器的过程，就不在此累述咯，大家可以在网上多查查相关资料。O(∩_∩)O~

有一点需要注意，为了让 Intellij IDEA 能够支持 markdown 语法，我们必须安装一个插件。

插件安装成功后，就能实现享受 markdown 语法高亮与所见即所得的双屏界面喽：

设计好后的页面文件，可以直接放入 zh_CN 文件夹中。

注意：文件后缀必须是 md 哦O(∩_∩)O~

4 运行

访问 http://localhost:port/zh_CN，页面会跳转到 http://localhost:port/zh_CN/#index.md；注意这里不是 index.html 哦。

如果你看到这个页面，那么恭喜你，你的基于 MarkDown 的 Wiki 系统已经搭建成功啦 O(∩_∩)O

---

如果出现白屏，有可能是因为项目所依赖的 jQuery 文件被屏蔽啦，打开 zh_CN/index.html 文件，修改 jquery 路径：

<script type="text/javascript" src="//code.jquery.com/jquery-1.12.4.min.js"></script>

然后再重新打开，就可以正常使用啦O(∩_∩)O~