本页仅介绍 DokuWiki 的核心编辑语法，适用于快速查阅。所有示例均可直接复制使用。

官方英文版说明»https://wiki.coolist.net/wiki/syntax

标题通过等号 `=` 定义，最多支持 5 级：

====== 一级标题 ======

===== 二级标题 =====

==== 三级标题 ====

=== 四级标题 ==

== 五级标题 =

注意：等号前后必须有空格，否则无法识别。

- 段落之间用空行分隔。

- 强制换行：在行尾添加两个反斜杠 `\\`

示例：

第一行文本\\

第二行文本

组合使用示例：`粗斜体` → 粗斜体

  - 项目一

  - 项目二

    - 子项目 A

    - 子项目 B

  1. 第一项

  2. 第二项

    1. 子项 1

    2. 子项 2

缩进用 2 或 4 个空格均可，保持层级一致即可。

[[页面名]]

[[命名空间:页面名]]

[[start|首页]]                # 自定义显示文字

[[#标题锚点|跳转到某节]]     # 页面内锚点

https://example.com           # 自动识别为链接

[[https://example.com|自定义文字]]

[[mailto:user@example.com|发邮件]]

图片需先上传至媒体管理器（或手动放入 `data/media/`），然后引用：

{{image.jpg}}                 # 原图

{{image.jpg?200x|替代文字}}   # 限制宽度为 200px

{{image.jpg?x150|替代文字}}   # 限制高度为 150px

{{命名空间:image.png?direct&200|文字}}  # 直链 + 缩放

支持 JPG、PNG、GIF、SVG（取决于服务器配置）。

使用 `^` 表示表头，`|` 表示普通单元格：

^ 姓名 ^ 年龄 ^ 城市 ^

| 张三 | 28   | 北京 |

| 李四 | 32   | 上海 |

对齐方式（可选）：

- 左对齐：`^左对齐 `

- 右对齐：` 右对齐^`

- 居中：` 居中 `

示例（居中表头）：

^  产品  ^  价格  ^

| 手机   | 3999  |

用两个单引号包围：

使用 ''config.php'' 文件进行配置。

<code>

echo "Hello World";

</code>

指定语言（需 syntaxhighlighter 插件支持）：

<code php>

<?php echo date('Y-m-d'); ?>

</code>

用 `>` 开头：

> 这是一段引用文字。

> 可以跨多行。

- 水平线：输入 4 个以上连字符

<code>----</code>

- 注释（仅编辑时可见，不渲染）：

<code><!-- 这是注释 --></code>

若需显示 DokuWiki 特殊符号本身（如 `**`），可用反斜杠转义：

\*\*不会变成粗体\*\*

或使用 HTML 实体（如 `&lt;` 表示 `<`）。

本语法速查基于 DokuWiki 默认配置编写，无需插件支持。

最后更新：2025年12月7日