必读教程

**知识点**

- 知识库中的文集，文档，文档层级，开放权限
- 知识库文档格式为 markdown 格式
- markdown 编辑器，在线与离线
- markdown 语法，基本与扩展
- 插入图片、链接与附件

# 1. 知识库的帮助文集

https://doc.mrdoc.pro/
有需要可以看以下两个部分：

- [觅思文档效果示例](https://doc.mrdoc.pro/p/example/ "觅思文档效果示例")
- [MrDoc 使用手册](https://doc.mrdoc.pro/p/user-guide/ "MrDoc 使用手册")

# 2. Markdown 基础知识

## 2.1 速查表

有经验的人查速查表能解决 95% 的问题
[markdown.com.cn](https://markdown.com.cn/cheat-sheet.html "markdown.com.cn")
[markdown.xyz](https://www.markdown.xyz/cheat-sheet/ "markdown.xyz")

## 2.1 基本语法

参考下面两个网站，内容基本一致
[markdown.com.cn](https://markdown.com.cn/basic-syntax/ "markdown.com.cn")
[markdown.xyz](https://www.markdown.xyz/basic-syntax/ "markdown.xyz")

## 2.2 扩展语法

考虑到兼容性，不建议使用除表格和代码块之外的扩展，特别不要使用表情包这种自定义扩展
[markdown.com.cn](https://markdown.com.cn/extended-syntax/ "markdown.com.cn")
[markdown.xyz](https://www.markdown.xyz/extended-syntax/ "markdown.xyz")

# 3. 编辑器

强烈建议使用知识库自带编辑器，文档实时保存在云端服务器，系统还会自动备份，作者可以定期导出自己的文档或文集到本地保存。

## 3.1 在线编辑器

- 知识库提供了 3 种在线编辑器，建议使用其中的 **Vditor**，

![](https://picgo.melands.cn/img/2023/06/08/2023-06-08_092359_3870140.6637118761613758.png)

- Vditor 可以预览桌面或者手机显示效果

![](https://picgo.melands.cn/img/2023/06/08/2023-06-08_093036_3381880.006386801697772171.png)

- Vditor 提供了三种编辑模式，通常使用**分屏预览**模式，编辑带表格文档时建议采用**所见即所得**模式更接近 word 的操作习惯。

![](https://picgo.melands.cn/img/2023/06/08/2023-06-08_093228_3957830.050183986923102886.png)

## 3.2 离线编辑器

离线编辑器有很多选择，常见的有

- VS code   适合写开发相关文档，如需要插入图片，联系叶建城配置图床插件
- Typora  功能强大，适合用作正式文档输出 pdf，付费软件，需要注册码以及设置图床，安装联系叶建城
- Notepad++ 记事本，适合日常使用，但无法插入图片

# 4. 测试附件

[【附件】2023/06/08/IT 流程图.vsdx](https://picgo.melands.cn/file/2023/06/08/IT%E6%B5%81%E7%A8%8B%E5%9B%BE.vsdx)

现场演示