整形記法

文章の整形を行うには、シンプルなマークアップ記法を用います。
DokuWiki の記法は、ソース自体もできるだけ読みやすくなるよう考慮されています。
画面の上部か下部にある編集ボタンをクリックすると、ページのソースを見ることができます。
このページでは、編集にあたって利用できる記法をすべて説明します。
ためしに編集をしてみたい場合には、 playground ページを使ってください。
主な記法は、quickbuttons からも利用できます。

基本的なテキスト整形

文字飾りとして太字、斜体、下線、等幅 を利用できます。
もちろん 組み合わせる こともできます。

文字飾りとして **太字**、 //斜体//、 __下線__ 、''等幅'' を利用できます。
もちろん **__//''組み合わせる''//__** こともできます。

さらに _下付きと ^上付きも使えます。

さらに <sub>下付き</sub> と <sup>上付き</sup> も使えます

~~取り消し線~~ も利用できます。

<del>取り消し線</del> も利用できます。

空行をおくと、段落となります。
段落内で 強制的に改行 するには、バックスラッシュ（日本語環境では円記号￥）を 2 つ連ねた後に空白文字を置くか改行します。

この文は改行
を含んでいます。2 連バックスラッシュが改行として処理されるのは、空白文字が続く
か行の最後

にある場合だけで、\\それ以外はそのまま表示されます。

この文は改行\\ を含んでいます。2 連バックスラッシュが
改行として処理されるのは、空白文字が続く\\ か行の最後\\
にある場合だけで、\\それ以外はそのまま表示されます。

強制改行は、どうしても必要な場合だけ使ってください。

注:

改行に関して、プラグインによりEnterキーを押すだけで出来るようになりました。上記の記法は不要です。

リンク

リンクの記述には様々な方法があります。

外部リンク

http://www.google.com や、よりシンプルに www.google.com のように文書中の URL は、外部リンクとして自動的に認識されます。
表題を指定して、googleへのリンクのようにもできます。
メールアドレスも、不等号で括ると、 andi@splitbrain.org のように自動的に認識されます。

http://www.google.com や、よりシンプルに www.google.com のように文書中の URL は、
外部リンクとして自動的に認識されます。表題を指定して、
[[http://www.google.com|googleへのリンク]] のようにもできます。
メールアドレスも、不等号で括ると、 <andi@splitbrain.org> のように自動的に認識されます。

内部リンク

この DokuWiki 内のページへのリンクには 2 連角カッコを使います。
ページ名そのままでpagename とするか、表題を指定します。

この DokuWiki 内のページへのリンクには 2 連角カッコを使います。ページ名そのままで 
[[pagename]] とするか、[[pagename|表題]] を指定します。

ページ名は自動的に小文字に変換されます。特殊文字は使えません。

ページ名をコロンで区切ると namespaces（名前空間）を利用できます。

ページ名をコロンで区切ると [[some:namespaces]]（名前空間）を利用できます。

詳細は namespaces をご覧ください。

ページ中の特定のセクションにリンクすることも可能です。
ハッシュ記号（#）に続けてセクション名を記述します。
このセクションへのリンクです。

[[syntax#internal|このセクション]] へのリンクです。

注:

既存のページへのリンクと存在しないページへのリンクとは表示が異なります。
デフォルト設定では CamelCase をリンクとして扱いません。config ファイルで変更できます。もし、「DokuWiki」がリンクになっていれば有効になっています。
セクションの見出しが変更されると、そこへのリンク名も変化します。セクションへのリンクは多用しないほうが良いでしょう。

Interwiki

Interwiki リンクも利用できます。
InterWikiは、他の Wiki に手軽にリンクを張るための方法です。
たとえば、Wiki は Wikipedia のページへのリンクです。

[[doku>Interwiki]] リンクも利用できます。
InterWikiは、他の Wiki に手軽にリンクを張るための方法です。
たとえば、[[wp>Wiki]] は Wikipedia のページへのリンクです。

Windows共有フォルダ

Windows 共有フォルダも this のように使えます。
ただし、イントラネット内のように、仲間内でしか正常に使えませんので、注意してください。

Windows 共有フォルダも [[\\server\share|this]] のように使えます。

注:

セキュリティ上、Windows 共有フォルダを直接ブラウズできるのは、デフォルトでは Microsoft Internet Explorer（の「ローカルゾーン」）のみに限られます。
Mozilla や Firefox では MozillaZine Knowledge Base にあるような対処を行うと有効にすることができます。と有効にすることができます。しかし、Windows Shareを開こうとするとJavaScriptの警告が表示されます。この警告を（すべてのユーザーに対して）取り除くには、以下の行をconf/lang/ja/lang.phpに記述してください（詳しくはlocalizationを参照してください）：
conf/lang/en/lang.php
```
<?php
/**
 * 英語ファイルのカスタマイズ
 * 修正が必要な文字列のみをコピーする。
 */
$lang['js']['nosmblinks'] = '';
```

画像にリンク

リンク記法と画像（後述）を組み合わせると、次のように、画像に内外部へのリンクをつけることができます。

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

注: リンクの表題については、この画像以外の整形記法は使えません。
画像とリンクの記法はすべてサポートされます
（画像のサイズ変更や、内外部イメージ、URL 指定や interwiki リンクなど）。

脚注

脚注 ¹⁾ には、2 連の丸カッコを用います。

脚注 ((これが脚注です)) には、2 連の丸カッコを用います。

セクション見出し

最大 5 つのレベルまでの見出しを使って、文章の構造化を行えます。
3 つ以上の見出しを記述すると、目次が自動的に生成されます。
文書中に ~~NOTOC~~ という文字列を書くと目次の生成を止めることができます。

第 3 見出し

第 4 見出し

第 5 見出し

==== 第 3 見出し ====
=== 第 4 見出し ===
== 第 5 見出し ==

水平線

ダッシュ (-) を四つ以上続けると、水平線が書けます。

画像やその他のファイル

波カッコを使って、画像やその他のファイルを記述できます（画像ファイルが wiki 内部にあっても外部でもかまいません）。
オプションで、画像サイズも指定できます。

実サイズ:

幅を変更:

幅と高さを変更²⁾:

外部イメージのサイズを変更:

実サイズ:                   {{wiki:dokuwiki-128.png}}
幅を変更:                   {{wiki:dokuwiki-128.png?50}}
幅と高さを変更:             {{wiki:dokuwiki-128.png?200x50}}
外部イメージのサイズを変更: {{https://www.php.net/images/php.gif?200x50}}

左右にスペース文字を記述すると、配置位置を指定できます。

{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}

さらに、タイトルも指定できます（ほとんどのブラウザで、ツールチップで表示されます）。

{{ wiki:dokuwiki-128.png |キャプションです}}

画像 (gif,jpeg,png) 以外のファイル名を指定すると（ファイルが内外部いずれでも）、そのファイルへのリンクとして表示されます。

画像を他のページへのリンクとするには、上記の画像にリンクをご覧ください。

サポートされるメディア形式

DokuWikiでは、以下のメディア形式を直接埋め込むことができます。

画像	`gif`, `jpg`, `png`
動画	`webm`, `ogv`, `mp4`
音声	`ogg`, `mp3`, `wav`
フラッシュ	`swf`

サポートされていないメディア形式を指定した場合、代わりにリンクとして表示されます。

?linkonlyを追加することで、インライン表示せずにメディアへのリンクを提供します。

{{wiki:dokuwiki-128.png?linkonly}}

dokuwiki-128.pngこれは単なる画像へのリンクです。

フォールバック・フォーマット

残念ながら、すべてのブラウザがすべてのビデオおよびオーディオ形式を理解しているわけではありません。
この問題を軽減するために、ブラウザの互換性を最大限に高めるために、異なる形式でファイルをアップロードすることができます。

たとえば、この埋め込みmp4ビデオを考えてみましょう。

{{video.mp4|面白いビデオ}}

参照されている video.mp4 の隣に video.webm と video.ogv をアップロードすると、DokuWiki は自動的にこれらのファイルを代替ファイルとして追加します。

さらにDokuWikiは、動画が始まる前に表示される「ポスター」画像をサポートしています。
この画像はビデオと同じファイル名で、jpgまたはpngファイルである必要があります。
上記の例では、video.jpgファイルが動作します。

テキストの変換

DokuWiki は特定の文字や文字列を、画像や他のテキスト、HTML などに変換することができます。
テキストから画像への変換機能は、主にスマイリーで使用されます。
テキストから HTML への変換機能は記号の変換に使用されますが、他の HTML に変換するように設定することもできます。

テキストから画像への変換

DokuWiki は一般的に使用されている顔文字を、同じような見た目を持つ画像に変換します。
このようなスマイリーや他の画像は、独自の設定で拡張することもできます。
標準で使用できるスマイリーは以下の通りです。

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

テキストから HTML への変換

記号: DokuWiki は、特定の文字列を活字表記的に同等な文字に変換することができます。以下に認識される文字列の例を示します。

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ®
“He thought 'It's a man's world'…”

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."

同様にして、どのような HTML でもパターンファイルを設定しておけば生成することができます。

パターンファイル設定による変換には、3 つの例外があります。
掛け算記号 (640×480)、'シングルクォート' および “ダブルクォート” です。
これらの変換は、設定オプションからオフにすることができます。

引用

ある文が、返信であったり、コメントであるということを表現したい場合もあります。その場合、次の記法を使います。

やった方が良いと思うけど。

> いや、やるべきではない！

>> まあ、やるべきでしょうね。

> ほんとに？

>> 本気です！

>>> では、やりましょう！

やった方が良いと思うけど。

いや、やるべきではない！

まあ、やるべきでしょうね。

ほんとに？

本気です！

では、やりましょう！

表

簡単な記法で表を作成できます。

見出し 1	見出し 2	見出し 3
行 1 列 1	行 1 列 2	行 1 列 3
行 2 列 1	列の結合 (後の縦線が2つであることに注意)
行 3 列 1	行 3 列 2	行 3 列 3

表の各行は通常 | （縦線）ではじめます。見出し行については、 ^ （ハット記号）ではじめます。

^ 見出し 1     ^ 見出し 2      ^ 見出し 3         ^
| 行 1 列 1    | 行 1 列 2     | 行 1 列 3        |
| 行 2 列 1    | 列の結合 (後の縦線が2つであることに注意) ||
| 行 3 列 1    | 行 3 列 2     | 行 3 列 3        |

セルを水平に結合するには、上記のように、後のセルの中身を完全に無しにします。
セルの区切りとなる縦線やハット記号は、どの行も同じ数だけ必要ですので注意してください。

列見出しも可能です。

	見出し 1	見出し 2
見出し 3	行 1 列 2	行 1 列 3
見出し 4	列の結合は今回は無し
見出し 5	行 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

これらのセルに ::: 以外の文字列を入力することはできません。

^ 見出し 1     ^ 見出し 2     ^ 見出し 3     ^
| 行 1 列 1    | 行の結合     | 行 1 列 3    |
| 行 2 列 1    | :::          | 行 2 列 3    |
| 行 3 列 1    | :::          | 行 2 列 3    |

表の内容の配置を指定できます。
2個以上のスペースをテキストの反対側に置きます。
つまり、右揃えにするには左側に2個のスペースを、左揃えにするには右側に2個のスペースを置きます。
中央揃えにするにはテキストの両側に2個以上のスペースを置きます。

配置を指定した表
右	中央	左
左	右	中央
xxxxxxxxxxxx	xxxxxxxxxxxx	xxxxxxxxxxxx

上記のソースは次のようになります。

^              配置を指定した表            ^^^
|            右|    中央      |左            |
|左            |            右|    中央      |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

注：縦アライメントには対応していません。

整形の無効化

もし入力した通りに (何も整形せずに) 表示する必要がある場合は、<nowiki> タグか、よりシンプルに 2 つの連続したパーセント記号 %% で挟みます。

このテキストには http://www.splitbrain.org のようなアドレスや**整形記法**を含みますが、実際には何も整形されません。
同様に //__この__スマイリー付きの//テキスト ;-) も整形されません。

<nowiki>
このテキストには http://www.splitbrain.org のようなアドレスや**整形記法**を含みますが、実際には何も整形されません。
</nowiki>
同様に %%//__この__スマイリー付きの//テキスト ;-)%% も整形されません。

コードブロック

2 つ以上の半角スペースでインデントするか、<code> もしくは <file> タグを使用することにより、コードブロックを記述することができます。

このテキストは 2 つの半角スペースによってインデントされています。

整形済みのコードです。スペースの数が次のように保持されます。例、                        <- ここ

同様ですが、ファイルの内容を示すときに使います。

上記のブロックは以下のようなソースから作成されています。

  このテキストは 2 つの半角スペースによってインデントされています。

<code>
整形済みのコードです。スペースの数が次のように保持されます。例、                        <- ここ
</code>

<file>
同様ですが、ファイルの内容を示すときに使います。
</file>

構文のハイライト

DokuWikiはソースコードの構文をハイライト表示して、読みやすくすることができます。
GeSHi という汎用の構文ハイライトソフトを使用しており、GeSHi がサポートするすべての言語を扱うことができます。
記法は、前述したコードブロックと同様ですが、言語の名称を <code java> や <file 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.
    }
}

現在のところ、次の言語がサポートされています。4cs, 6502acme, 6502kickass, 6502tasm, 68000devpac, abap, actionscript3, actionscript, ada, aimms, algol68, apache, applescript, apt_sources, arm, asm, asp, asymptote, autoconf, autohotkey, autoit, avisynth, awk, bascomavr, bash, basic4gl, batch, bf, biblatex, bibtex, blitzbasic, bnf, boo, caddcl, cadlisp, ceylon, cfdg, cfm, chaiscript, chapel, cil, c_loadrunner, clojure, c_mac, cmake, cobol, coffeescript, c, cpp, cpp-qt, cpp-winapi, csharp, css, cuesheet, c_winapi, dart, dcl, dcpu16, dcs, delphi, diff, div, dos, dot, d, ecmascript, eiffel, email, epc, e, erlang, euphoria, ezt, f1, falcon, fo, fortran, freebasic, freeswitch, fsharp, gambas, gdb, genero, genie, gettext, glsl, gml, gnuplot, go, groovy, gwbasic, haskell, haxe, hicest, hq9plus, html, html4strict, html5, icon, idl, ini, inno, intercal, io, ispfpanel, java5, java, javascript, jcl, j, jquery, julia, kixtart, klonec, klonecpp, kotlin, latex, lb, ldif, lisp, llvm, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, mathematica, matlab, mercury, metapost, mirc, mk-61, mmix, modula2, modula3, mpasm, mxml, mysql, nagios, netrexx, newlisp, nginx, nimrod, nsis, oberon2, objc, objeck, ocaml-brief, ocaml, octave, oobas, oorexx, oracle11, oracle8, oxygene, oz, parasail, parigp, pascal, pcre, perl6, perl, per, pf, phix, php-brief, php, pic16, pike, pixelbender, pli, plsql, postgresql, postscript, povray, powerbuilder, powershell, proftpd, progress, prolog, properties, providex, purebasic, pycon, pys60, python, qbasic, qml, q, racket, rails, rbs, rebol, reg, rexx, robots, roff, rpmspec, rsplus, ruby, rust, sas, sass, scala, scheme, scilab, scl, sdlbasic, smalltalk, smarty, spark, sparql, sql, sshconfig, standardml, stonescript, swift, systemverilog, tclegg, tcl, teraterm, texgraph, text, thinbasic, tsql, twig, typoscript, unicon, upc, urbi, uscript, vala, vbnet, vb, vbscript, vedit, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, whois, winbatch, wolfram, xbasic, xml, xojo, xorg_conf, xpp, yaml, z80, zxbasic

advanced optionsさらに、シンタックスハイライトには、行のハイライトや行番号の追加などがあります。

ダウンロード可能なコードブロック

前述の <code> や <file> タグを使用した場合、示されているコードをダウンロード可能にしたいと思われるかもしれません。
以下のように言語名の後にファイル名を記入することで、そのコードをダウンロード可能にすることができます。

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

myexample.php

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

構文のハイライトは不要だがダウンロードは可能にしたい場合は、<code - myfile.foo> のように言語の名称としてハイフンマイナス (-) を使用してください。

RSS/ATOM フィードの取り込み

DokuWikiは外部のXMLフィードからのデータを統合できます。
XMLフィードの解析には SimplePie を使っています。
DokuWikiではSimplePieが解釈可能な全てのフォーマットが利用できます。
スペースで区切られた複数の引数で表示をカスタマイズできます：

パラメータ	意味
数字	最大表示数。デフォルト8
reverse	表示順を逆にする。
author	作者を表示する。
date	日付を表示する。
description	概要を表示する。含まれる全てのHTMLタグは無効になります。
数字[dhm]	更新間隔。数字の後の文字の意味は d=日、h=時間、m=分。（例 12h = 12時間）

更新間隔のデフォルトは4時間です。10分未満の値は10分として扱われます。
通常DokuWikiはページのキャッシュされたバージョンを提供しようとしますので、動的な外部の内容を含めるのは明らかに不適当です。
このパラメータによって、ページが最後に描画されてから更新間隔以上経っていたらDokuWikiはキャッシュを破棄して再描画をします。

デフォルトでは、フィードは日付順に新しいものから並べられます。
reverse パラメータを使用して古い順に並べ替えたり、あるいは nosort を使用してフィードをそのまま表示したりすることができます。

例：

{{rss>http://slashdot.org/index.rss 5 author date 1h }}

Laptop Mag Is Shutting Down by BeauHD (2025/07/02 10:25)
Apple Accuses Former Engineer of Taking Vision Pro Secrets To Snap by BeauHD (2025/07/02 09:45)
Tinder To Require Facial Recognition Check For New Users In California by BeauHD (2025/07/02 09:02)
Figma Files For IPO by BeauHD (2025/07/02 08:20)
Xerox Buys Lexmark For $1.5 Billion As Print Industry Clings To Relevance by BeauHD (2025/07/02 08:00)

制御用のマクロ

いくつかの構文は、それ自身は出力されないものの、DokuWiki の動作に影響を及ぼします。以下のような制御用のマクロが利用可能です。

マクロ	説明
~~NOTOC~~	このマクロがページ上にあった場合、目次が生成されなくなります。
~~NOCACHE~~	デフォルトでは、DokuWiki はすべての出力をキャッシュします。この動作は、場合によっては望まれないことがあります (<php> タグが使用されている場合など)。このマクロを追加することにより、DokuWiki に毎回強制的にページを再描画させることができます。

記法のプラグイン

DokuWiki の記法は、プラグインを使って拡張することができます。
各プラグインの使用方法は、各プラグインの解説ページにあります。この DokuWiki では、次の記法プラグインが使用可能となっています。

Changes Plugin 2023-12-14 by Andreas Gohr
List the most recent changes of the wiki
Gallery Plugin 2024-04-30 by Andreas Gohr
Creates a gallery of images from a namespace or RSS/ATOM feed
htmlok plugin 2023-05-10 by saggi, glen
Allows embed HTML and PHP
Info Plugin 2020-06-04 by Andreas Gohr
Displays information about various DokuWiki internals
Pagelist Plugin 2023-08-27 by Matthias Schulte, Michael Hamann, Michael Klier, Gina Haeussge
Lists pages in a nice formatted way
struct plugin 2025-05-12 by Andreas Gohr, Michael Große, Anna Dabrowska
Add and query additional structured page data
Video Sharing Site Plugin 2025-02-21 by Andreas Gohr
Easily embed videos from various Video Sharing sites. Example: {{youtube>XXXXXX}}
Wrap Plugin 2023-08-13 by Anika Henke
Universal plugin which combines functionalities of many other plugins. Wrap wiki text inside containers (divs or spans) and give them a class (choose from a variety of preset classes), a width and/or a language with its associated text direction.

¹⁾

これが脚注です

²⁾

画像のアスペクト比と指定された幅と高さの比が異なる場合は、リサイズされる前に新しいアスペクト比に切り抜かれます。

目次