DokuWiki поддерживает язык разметки, который по возможности сохраняет файлы данных как можно более читабельными! Здесь перечислены все возможные синтаксические конструкции, которые можно использовать при редактировании страниц. Просто посмотрите на исходный код этой страницы, нажав кнопку Отредактировать страницу вверху или внизу страницы.

DokuWiki поддерживает выделение текста жирным шрифтом, курсивом, подчеркнутый текст и вывод текста моноширинным шрифтом. Все эти конструкции можно объединить.

DokuWiki поддерживает выделение текста
**жирным шрифтом**,
//курсивом//,
__подчеркниванием текста__
и вывод текста ''моноширинным шрифтом''. 
Все эти конструкции можно **__//''объединить''//__**.

Также можно использовать _{подстрочный} и ^{надстрочный} индексы.

Также можно использовать <sub>подстрочный</sub> и <sup>надстрочный</sup> индексы.

Ещё можно зачеркнуть текст.

Ещё можно <del>зачеркнуть текст</del>.

Параграфы отбиваются пустой строкой. Если нужно принудительно вставить перенос строки, не создавая параграф, вставьте два обратных слэша и за ним пробел или энтер.

Просто текст с разрывом строк
Обратите внимание, что два обратных слэша действуют только в конце строки
или если за ними стоит
пробел. Если его не поставить, \\получится вот так.

Просто текст с разрывом строк\\ Обратите внимание,
что два обратных слэша действуют только в конце строки\\
или если за ними стоит\\ пробел. Если его не поставить, \\получится вот так.

Принудительные переносы следует использовать только в случае крайней необходимости.

Ссылки в DokuWiki бывают разные, и создавать их можно тоже по-разному.

Внешние ссылки распознаются автоматически: http://www.uolbt.yanao.ru или просто www.uolbt.yanao.ru — также можно указывать текст ссылки: Это ссылка на uolbt. Адреса электронной почты тоже распознаются: user@yanao.ru.

Внешние ссылки распознаются автоматически: http://www.uolbt.yanao.ru или
просто www.uolbt.yanao.ru --- также можно указывать текст ссылки:
[[http://www.uolbt.yanao.ru|Это ссылка на uolbt]]. Адреса электронной почты
тоже распознаются: <user@yanao.ru>.

Внутренние ссылки создаются посредством квадратных скобок. Можно либо просто указать Имя страницы, либо дополнительно прописать Текст ссылки. Имена Wiki-страниц автоматически переводятся в нижний регистр, спецсимволы использовать нельзя.

Внутренние ссылки создаются посредством квадратных скобок.
Можно либо просто указать [[Имя страницы]], либо дополнительно прописать
[[Имя страницы|Текст ссылки]]. Имена Wiki-страниц автоматически 
переводятся в нижний регистр, спецсимволы использовать нельзя.

Можно использовать в ссылке namespaces (пространство имён) через двоеточие.

Можно использовать в ссылке [[namespaces]] (пространство имён) через двоеточие.

Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку имя раздела, также как это делается в HTML. Ссылка на этот раздел.

Ссылка на [[syntax#внутренние|этот раздел]].

Примечания:

• Ссылки на существующие страницы отображаются иначе, чем ссылки на несуществующие страницы
• Внутренние ссылки без указанного текста могут отображаться по разному в зависимости от настроек - в качестве текста может использоваться название страницы или заголовок первого уровня¹⁾. Так что лучше каждый раз указывать текст ссылки.
• DokuWiki по умолчанию не использует CamelCase для автоматического создания ссылок, но эту возможность можно включить в файле wiki:config. Проверка: Если DokuWiki — ссылка, значит эта возможность включена.
• Если меняется название раздела, ссылки на него не меняются автоматически. Так что не очень полагайтесь на ссылки на разделы.

DokuWiki поддерживает InterWiki-ссылки. Это короткие ссылки на другие Wiki. Например, вот ссылка на страницу Википедии о Wiki: Wiki.

Например, вот ссылка на страницу Википедии о Wiki: [[wp>Wiki]].

Ссылки на сетевые ресурсы вида \\server\share тоже распознаются. Однако учтите, что такие ссылки имеют смысл только в гомогенных группах пользователей, например в корпоративном Интранете.

Ссылки на виндовые шары вида \\server\share тоже распознаются.

Примечания:

• Из соображений безопасности непосредственный просмотр виндовых шар работает по умолчанию только в Internet Explorer (и только в “локальной зоне”).
• В Mozilla и Firefox эту возможность можно включить с помощью опции security.checkloaduri, но делать это не рекомендуется.
• Подробней читайте здесь: 151.

Совместив синтаксис ссылки и картинки, можно вставить в текст картинку, которая будет внутренней или внешней ссылкой:

[[http://www.php.net|{{dokuwiki-128.png}}]]

Учтите: форматирование картинок это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки.

С помощью двойных скобок можно добавить сноску²⁾.

С помощью двойных скобок можно добавить сноску ((Это сноска)).

Для структурирования текста можно использовать до пяти уровней заголовков. Если в тексте больше трёх заголовков 3-го уровня и выше, автоматически создаётся список содержимого. Его можно отключить, вставив в документ строку ~~NOTOC~~.

==== Заголовок 3-го уровня ====
=== Заголовок 4-го уровня ===
== Заголовок 5-го уровня ==

Четыре и более тире преобразуются в горизонтальную черту:

----

С помощью фигурных скобок можно вставлять в текст внешние и внутренние картинки. По желанию можно указать их размер.

Нормальный размер:

Отмасштабированная до заданной ширины:

Отмасштабированная до заданных размеров:

Отмасштабированная внешняя картинка:

Нормальный размер:                        {{dokuwiki-128.png}}
Отмасштабированная до заданной ширины:    {{dokuwiki-128.png?50}}
Отмасштабированная до заданных размеров:  {{dokuwiki-128.png?200x50}}
Отмасштабированная внешняя картинка:      {{http://de3.php.net/images/php.gif?200x50}}

Поставив слева или справа пробел можно задать выравнивание картинки:

{{dokuwiki-128.png }}
{{ dokuwiki-128.png}}
{{ dokuwiki-128.png }}

И, конечно, картинке можно задать название (в большинстве браузеров оно отображается в виде всплывающей подсказки).

{{ dokuwiki-128.png |Название картинки}}

Если задать имя файла (внутреннее или внешнее), который не является картинкой (gif, jpeg, png), оно будет отображаться в виде ссылки.

Dokuwiki поддерживает нумерованные и ненумерованные списки. Чтобы создать элемент списка, поставьте в начале строки два пробела и потом * в случае ненумерованного списка, или - в случае нумерованного.

• Это список
  • Второй элемент списка
    • Можно сделать вложенный список
  • Ещё один элемент

1. Тот же список, только нумерованный
2. Ещё элемент
   1. Чем больше пробелов в начале, тем глубже вложенность
3. Всё просто

  * Это список
    * Второй элемент списка
      * Можно сделать вложенный список
    * Ещё один элемент

  - Тот же список, только нумерованный
  - Ещё элемент
    - Чем больше пробелов в начале, тем глубже вложенность
  - Всё просто

DokuWiki преобразует наиболее употребляемые смайлики в их графические эквиваленты. Дополнительные смайлики можно положить в директорию smiley и внести изменения в файл conf/smileys.conf. Вот смайлики, которые есть в DokuWiki:

• 8-)
• 8-O
• :-(
• :-)
• =)
• :-/
• :-\
• :-?
• :-D
• :-P
• :-O
• :-X
• :-|
• ;-)
• ^_^
• :?:
• :!:
• LOL
• FIXME
• DELETEME

DokuWiki может переделывать символы, набранные простым текстом, в их типографски корректные эквиваленты. Распознаются следующие символы.

→ ← ↔ ⇒ ⇐ ⇔ » « – — '640×480' © ™ ®
«Владимир Владимирович™ — это наше всё © не я»

-> <- <-> => <= <=> >> << -- --- '640x480' (c) (tm) (r)
"Владимир Владимирович(tm) --- это наше всё (c) не я"

Примечание: Это конвертирование можно отключить в файле конфигурации.
Примечание 2: Если потребуется вставить двойные кавычки (" или "), например как знак дюйма , можно их экранировать %%:

%%"%% или ''%%"%%''

Иногда нужно пометить некоторый текст в качестве ответа или комментария. Для этого можно использовать следующий синтаксис:

Я думаю, мы должны это сделать.
> Нет, мы не должны.
>> Ну, я говорю, что мы должны.
> Действительно?
>> Да!
>>> Тогда сделаем это!

Я думаю, мы должны это сделать.

Нет, мы не должны.

Ну, я говорю, что мы должны.

Действительно?

Да!

Тогда сделаем это!

DokuWiki поддерживает упрощённый синтаксис создания таблиц.

Нормальные ряды должны начинаться и заканчиваться символом |, а заголовки — ^.

^ Заголовок 1      ^ Заголовок 2         ^ Заголовок 3            ^
| Ряд 1 Колонка 1  | Ряд 1 Колонка 2     | Ряд 1 Колонка 3        |
| Ряд 2 Колонка 1  | Объединение колонок (обратите внимание на двойную вертикальную черту)  ||
| Ряд 3 Колонка 1  | Ряд 2 Колонка 2     | Ряд 2 Колонка 3        |

Чтобы объединить две соседние клетки в ряду, просто оставьте соседнюю клетку полностью пустой, как показано выше. Следите, чтобы количество разделителей клеток было одинаковым!

Вертикальные заголовки тоже можно сделать.

Как легко увидеть, разделитель стоящий перед клеткой определяет форматирование:

|              ^ Заголовок 1       ^ Заголовок 2      ^
^ Заголовок 3  | Ряд 1 Колонка 2   | Ряд 1 Колонка 3  |
^ Заголовок 4  | Объединения нет   |                  |
^ Заголовок 5  | Ряд 2 Колонка 2   | Ряд 2 Колонка 3  |

Можно сделать вертикально объединённые ячейки добавлением трёх двоеточий ::: в объединяемые нижележащие ячейки.

В этих ячейках не должно быть ничего, кроме синтаксиса объединения (:::).

^ Заголовок 1        ^ Заголовок 2                       ^ Заголовок 3            ^
| Ряд 1 Колонка 1    | эта ячейка объединена вертикально | Ряд 1 Колонка 3        |
| Ряд 2 Колонка 1    | :::                               | Ряд 2 Колонка 3        |
| Ряд 3 Колонка 1    | :::                               | Ряд 2 Колонка 3        |

Текст клетки таблицы можно выравнивать. Просто добавьте минимум два пробела с противоположной стороны: слева — если надо выравнять вправо, справа – если надо выравнять влево, и по два с каждой стороны — если по центру.

^           Таблица с выравниванием        ^^^
|        вправо|   по центру  |влево         |
|влево         |        вправо|   по центру  |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Неформатируемые блоки можно вставлять в документ, либо начиная каждую строчку блока с двух или более пробелов (как это делалось в некоторых предыдущих примерах), либо используя тэги <code> или <file>. При этом пробелы в начале строки являются эквивалентом применения тега <code> к одной строке, но без подсветки кода. Если несколько подряд идущих строк начинаются более чем с одного пробела, они объединяются в один блок <code>.

Пример использования <code>..</code>.

Это неформатированный текст, в котором сохранены все пробелы: вот             <- так.

Пример использования <file>..</file>.

В принципе то же самое, но этим выделением можно показать, 
что цитируется содержимое файла.

Чтобы парсер полностью проигнорировал некий текст (т.е. не форматировал его), либо заключите его в тэги <nowiki>, либо ещё проще — в двойные знаки процента %%.

Это просто текст, в котором есть адрес http://www.splitbrain.org и **форматирование** — но ничего не происходит.

Это просто текст, в котором есть адрес %%http://www.splitbrain.org%% 
и %%**форматирование**%% --- но ничего не происходит.

Чтобы увидеть, как используются эти блоки, смотрите код страницы.

DokuWiki может подсвечивать <hi>программный код</hi>, чтобы его было проще читать. Для этого используется библиотека GeSHi — соответственно подсвечиваются все языки, поддерживаемые GeSHi. Синтаксис такой же, как и в блоке code в предыдущем разделе, но на этот раз внутри тэга добавляется название языка. Например <code java>.

/** 
 * The HelloWorldApp class implements an application that
 * simply displays "Hello World!" to the standard output.
 */
class HelloWorldApp {
    public static void main(String[] args) {
        System.out.println("Hello World!"); //Display the string.
    }
}

На данный момент распознаются следующие языки:

~~COL:7~~

, 4cs
, **a**bap
, actionscript-french
, actionscript
, actionscript3
, ada
, apache
, applescript
, asm
, asp
, autoconf
, autohotkey
, autoit
, avisynth
, awk
, **b**ash
, basic4gl
, bf
, bibtex
, blitzbasic
, bnf
, boo
, **c**
, c_mac
, caddcl
, cadlisp
, cfdg
, cfm
, chaiscript
, cil
, clojure
, cmake
, cobol
, cpp
, cpp-qt
, csharp
, css
, cuesheet
, **d**
, dcs
, delphi
, diff
, div
, dos
, dot
, **e**cmascript
, eiffel
, email
, erlang
, **f**o
, fortran
, freebasic
, fsharp
, **g**ambas
, genero
, genie
, gdb
, glsl
, gml
, gnuplot
, groovy
, gettext
, gwbasic
, **h**askell
, hicest
, hq9plus
, html
, **i**con
, idl
, ini
, inno
, intercal
, io
, **j**
, java5
, java
, javascript
, jquery
, **k**ixtart
, klonec
, klonecpp
, **l**atex
, lisp
, locobasic
, logtalk
, lolcode
, lotusformulas
, lotusscript
, lscript
, lsl2
, lua
, **m**68k
, magiksf
, make
, mapbasic
, matlab
, mirc
, modula2
, modula3
, mmix
, mpasm
, mxml
, mysql
, **n**ewlisp
, nsis
, **o**beron2
, objc
, ocaml-brief
, ocaml
, oobas
, oracle8
, oracle11
, oxygene
, oz
, **p**ascal
, pcre
, perl
, perl6
, per
, pf
, php-brief
, php
, pike
, pic16
, pixelbender
, plsql
, postgresql
, povray
, powerbuilder
, powershell
, progress
, prolog
, properties
, providex
, purebasic
, python
, **q**
, qbasic
, **r**ails
, rebol
, reg
, robots
, rpmspec
, rsplus
, ruby
, **s**as
, scala
, scheme
, scilab
, sdlbasic
, smalltalk
, smarty
, sql
, systemverilog
, **t**cl
, teraterm
, text
, thinbasic
, tsql
, typoscript
, **u**nicon
, **v**ala
, vbnet
, vb
, verilog
, vhdl
, vim
, visualfoxpro
, visualprolog
, **w**hitespace
, winbatch
, whois
, **x**basic
, xml
, xorg_conf
, xpp
, **z**80

Используя тэги <code> или <file>, как показано выше, вы можете сделать отображаемый код доступным для загрузки. Для этого определите имя файла после кода языка вот так:

<file php myexample.php>
<?php echo "hello world!"; ?>
</file>

myexample.php

<?php echo "hello world!"; ?>

Если вам не нужна подсветка, но нужен загружаемый файл, поставьте прочерк (-) на месте кода языка: <code - myfile.foo>.

Чистый HTML- или PHP-код можно вставлять в документ с помощью тэгов html и php:

<html>
Тут вставлен <font color="red" size="+1">HTML-код</font>
</html>

Тут вставлен <font color="red" size="+1">HTML-код</font>

<php>
echo 'Логотип, сгенерированный PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="Логотип PHP!" />';
</php>

echo 'Логотип, сгенерированный PHP:'; echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="Логотип PHP!" />';

Примечание: по умолчанию вставка HTML и PHP запрещена. Когда она запрещена, код не исполняется, а выводится в исходном виде.

Некоторый синтаксис влияет на то, как «ДокуВики» обрабатывает статьи без создания каких-либо результатов для себя. Доступны следующие макросы:

DokuWiki может отображать на своих страницах данные из внешних XML-фидов. Для парсинга XML-фидов используется библиотека SimplePie, соответственно, все форматы, распознаваемые этой библиотекой поддерживаются в DokuWiki. Вывод информации можно настроить, используя следующие параметры (параметры надо разделять пробелами):

По умолчанию период обновления равен 4 часам. Если указать значение меньше 10 минут, то DokuWiki всё-равно будет обновлять не чаще, чем раз в 10 минут. По умолчанию DokuWiki выдаёт пользователю сохранённую версию страницы, однако указание периода обновления фида приводит к повторному рендерингу страницы.

Пример:

{{rss>http://wsrss.bbc.co.uk/russian/index.xml 7 author date 10h }}

• Произошла ошибка при получении новостной ленты: http://wsrss.bbc.co.uk/russian/index.xml

Синтаксис «ДокуВики» может быть расширен за счёт плагинов. Как их устанавливать и использовать — описывается на страницах описания. На этом сайте установлены следующие модули, которые расширяют стандартное форматирование DokuWiki:

• a2s plugin 2022-06-21 — Schplurtz le Déboulonné
  Convert ASCII art diagram to nice embedded SVG images.
• Add New Page 2015-11-02 — Benjamin Santalucia, Sam Wilson, Michael Braun, Gerrit Uitslag, Albert Chern
  Adds a "new page form" to any wiki page.
• Blog 2022-09-08 — Michael Hamann, Michael Klier, Gina Haeussge
  Use DokuWiki as blogging tool. (previous authors: Esther Brunner)
• Bootstrap Wrapper Plugin 2022-09-22 — Giuseppe Di Terlizzi
  Bootstrap Wrapper for DokuWiki
• Box Plugin 2022-08-16 — Christopher Smith
  Boxes with titles, colour and rounded corners. Syntax: <box width class colours|title> ... </box|caption> width, class, colours title & caption are optional. The title can include some wiki markup, the box contents can include almost any wiki markup.
• ckgedit 2022-10-06 — Myron Turner
  WYSIWYG plugin for Dokuwiki
• Cloud Plugin 2022-09-28 — Michael Hamann, Michael Klier, Gina Haeussge
  Displays the most used words in a word cloud.
• discussion plugin 2021-12-31 — Michael Hamann, Gerrit Uitslag, Gina Häussge, Christopher Smith, Michael Klier, Esther Brunner, Matthias Schulte
  Provides discussion funtionality for wiki pages
• Gallery Plugin 2021-09-11 — Andreas Gohr
  Creates a gallery of images from a namespace or RSS/ATOM feed
• Icons Plugin 2019-08-27 — Giuseppe Di Terlizzi
  Embed icons in Dokuwiki
• include plugin 2022-01-23 — Michael Hamann, Gina Häussge, Christopher Smith, Michael Klier, Esther Brunner
  Functions to include another page in a wiki page
• Indexmenu Plugin 2022-08-01 — Samuele Tognini
  Show a customizable and sortable index for a namespace
• Info Plugin 2020-06-04 — Andreas Gohr
  Displays information about various DokuWiki internals
• keyboard 2020-09-27 — Gina Häußge
  The keyboard plugin provides a combined syntax and action plugin in order to markup text as keyboard keys, similar to (and making use of) the existing (X)HTML tag <kbd>…</kbd>. A quick button for the markup is automatically inserted into the toolbar of the edit form.
• Linkback plugin 2022-08-03 — Michael Hamann, Gina Häußge
  Adds Trackback and Pingback support to DokuWiki
• nosidebar plugin 2013-07-14 — Matthias Schulte
  Disables DokuWikis internal sidebar for individual pages
• Note Plugin 2020-06-28 — Olivier Cortès, Eric Hameleers, Christopher Smith, Aurélien Bompard, LarsDW223
  Add Note/Important/Tip/Warning Capability (DIV+CSS box)
• Pagelist Plugin 2022-09-28 — Matthias Schulte, Michael Hamann, Michael Klier, Gina Haeussge
  Lists pages in a nice formatted way
• Tag Plugin 2022-10-02 — Michael Hamann, Gina Häussge, Christopher Smith, Michael Klier, Esther Brunner
  tag wiki pages
• Video Sharing Site Plugin 2022-02-03 — Andreas Gohr
  Easily embed videos from various Video Sharing sites. Example: {{youtube>XXXXXX}}

Текст можно выделять цветом. <hi>Цвет по умолчанию</hi> может быть заменён на какой-либо другой, например <hi red>красный</hi> или <hi lightblue>голубой</hi>.

Текст можно выделять цветом.
<hi>Цвет по умолчанию</hi> может быть заменён на какой-либо другой, 
например <hi red>красный</hi> или <hi lightblue>голубой</hi>.

Плагин Note позволяет легко оформлять всевозможные комментарии и заметки:

<note>обычная заметка</note>
<note tip>заметка-подсказка</note>
<note important>важная заметка</note>
<note warning>заметка-предупреждение</note>

ссылка на плагин: http://www.dokuwiki.org/plugin:note

Это основная часть плагина. Включив инструкцию «~~DISCUSSION~~» на свою вики-страницу, раздел обсуждения будет добавлен после обычного содержимого вики-страницы. Чтобы снова выключить его, используйте ~~DISCUSSION:off~~. Если вы хотите показать существующее обсуждение, но не хотите разрешать новые комментарии / ответы, используйте~~DISCUSSION:closed~~.

  ~~DISCUSSION~~
  ~~DISCUSSION:off~~
  ~~DISCUSSION:closed~~

Пользовательский заголовок может быть добавлен после разделителя |.

  ~~DISCUSSION|Пользовательская строка заголовка~~
  ~~DISCUSSION:closed|Пользовательская строка заголовка~~

После каждого комментария в разделе обсуждения может быть до трех кнопок (в зависимости от ваших прав).:

• Ответить: Чтобы ответить на комментарий (в отличие от комментариев к содержимому вики-страницы), нажмите кнопку «Ответить». Затем форма для ввода комментариев будет размещена соответствующим образом.
• Редактировать: Зарегистрированные пользователи могут редактировать свои комментарии; администраторы могут редактировать все комментарии. Чтобы удалить комментарий, просто отредактируйте его, очистите текст и сохраните пустой комментарий - как вы бы сделали с вики-страницей.
• Удалить: Зарегистрированные пользователи и администратор все комментарии. Внимание: Если есть ответы на комментарий, его удаление также приведет к удалению всех ответов!
• Скрыть / показать: Администраторы могут легко деактивировать и повторно активировать комментарии с помощью этой кнопки. Скрытые комментарии не показываются обычным пользователям и отображаются затемненными для администраторов. Зарегистрированные пользователи могут скрывать только свои собственные комментарии. Скрытие комментария также скрывает его ответы.