一、Markdown简介
Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的HTML文档。Markdown编写的文档可以导出为HTML、Word、图像、PDF、Epub等多种格式的文档。Markdown文档的后缀为.md,.markdown。
二、Markdown在DokuWiki中的应用
DokuWiki是一款基于PHP的开源Wiki软件,它以简洁、易用、可扩展而著称。Markdown的引入使得DokuWiki的排版更加灵活,提高了文档编辑的效率。
1. 基础语法
标题:使用#号标记,可以标识1-6级标题。注意#后面要加空格。
- 代码:
# 一级标题 ## 二级标题 ### 三级标题 #### 四级标题 ##### 五级标题 ###### 六级标题
- 效果:
- 一级标题
- 二级标题
- 三级标题
- 四级标题
- 五级标题
- 六级标题
字体:星号与下划线都可以,单独一个星号是斜体,两个是粗体,三个是粗斜体。
- 代码:
这是斜体 这是斜体 这是粗体 这是粗体 这是粗斜体 这是粗斜体
- 效果:
- 这是斜体
- 这是斜体
- 这是粗体
- 这是粗体
- 这是粗斜体
- 这是粗斜体
换行:直接在一句话后敲两个空格,或者两句话之间加一个空行。
- 代码:
这是第一行 这是第二行
- 效果:
- 这是第一行
- 这是第二行
引用:使用>符号实现引用效果,引用允许换行。如果结束,加一个空白行即可。
- 代码:
>这是一层引用 >>这是二层引用 >>>这是三层引用
- 效果:
- 这是一层引用
- 这是二层引用
- 这是三层引用
链接:使用描述为文字增加外链接。
- 代码:
[链接地址](https://www.example.com)
- 效果:
- 链接地址
图片:复制图片粘贴到Markdown编辑页面即可插入图片,图片大小可通过设置长宽或者百分比。
- 代码:

- 效果:
2. 高级语法
表格:使用竖线(|)和短横线(-)创建表格。
- 代码:
| 表头1 | 表头2 | 表头3 | | --- | --- | --- | | 内容1 | 内容2 | 内容3 | | 内容4 | 内容5 | 内容6 |
- 效果:
- 表头1 表头2 表头3 - 内容1 内容2 内容3 - 内容4 内容5 内容6
代码块:使用三个反引号(”)包裹代码,可以指定编程语言。
- 代码:
```python print("Hello, Markdown!")
- 效果: ```python print("Hello, Markdown!")
三、Markdown在DokuWiki中的实用技巧
- 自定义样式:通过编辑DokuWiki的配置文件,可以自定义Markdown的样式,例如字体、颜色等。
- 插件扩展:DokuWiki拥有丰富的插件,可以扩展Markdown的功能,例如语法高亮、表格样式等。
- 版本控制:Markdown文件因为是纯文本格式,非常适合版本控制。可以使用Git等版本控制系统管理Markdown文档。
四、总结
Markdown在DokuWiki中的应用,使得文档排版更加灵活,提高了协作效率。掌握Markdown的基本语法和实用技巧,可以让你在DokuWiki中轻松排版,高效协作。