ここでは、プラグインについてはよく使われるものだけを簡略に説明しています。プラグインのオプションなど詳細な説明についてはpukiwiki:PukiWiki/プラグイン/1.4を参照してください。
ブロック要素 †
- ブロック要素は、インライン要素と他のブロック要素を子要素にすることができます。ただし、段落、見出し、水平線、#から始まるブロック要素は他のブロック要素を子要素にすることはできません。
- 空行はトップレベルのブロック要素の区切りになります。空行が現われると、すべてのブロック要素は終了します。
- ブロック要素は、他のブロック要素の子要素になることができます。
- リスト構造と引用文は他のブロック要素を子要素にすることができます。子要素のブロック要素は親要素のレベルに従ってインデントされて表示されます。空行が現われるとブロック要素は終了します。
- リスト構造と引用文のネストには3段階のレベルがありますが、リスト構造のレベルと引用文のレベルは独立しています。従って、リスト構造を引用文の子要素にする場合や引用文をリスト構造の子要素にする場合は、レベルを1段階増やさずに記述します。リスト構造を他のリスト構造の子要素にする場合や引用文を他の引用文の子要素にする場合は、レベルを1段階増やして記述します。
- 他のブロック要素の子要素となっている引用文から脱出するとき、親のブロック要素を継続したい場合は行頭に<、<<、<<<を記述します。<で第1レベルの引用文から、<<で第2レベルの引用文から、<<<で第3レベルの引用文から脱出します。空行を記述すると引用文だけでなく親のブロック要素からも脱出します。
- ブロック要素となるプラグインは#〜の形式になっています。
段落 †
インライン要素
他のブロック要素を明示しない限り、段落となります。
~インライン要素
行頭で~を指定した場合も段落になります。行頭書式の文字(~、-、+、:、>、|、#、//)を通常の文字として段落の先頭に書きたい場合は、行頭に~を記述して書くことができます。
- 段落の先頭は1文字分字下げされます。但し、番号なしリスト構造、番号付きリスト構造、引用文内の段落では字下げされません。定義リスト内の段落の先頭は1文字分字下げされます。
- 段落は、新たなブロック要素が現われるまで継続します。
- 段落は、他のブロック要素の子要素になることができます。
- 段落は、他のブロック要素を子要素にすることはできません。
引用文 †
>インライン要素
行頭で>を指定すると、引用文になります。引用文は >、>>、>>> の3レベルあります。
- 引用文の中は、ブロック要素を明示しない限り、段落となります。
- 引用文は、空行が現われるまで継続します。
- 引用文内の段落は、新たな引用文またはブロック要素が現われるまで継続します。
- 引用文は、他のブロック要素の子要素になることができます。他の引用文の子要素にする場合は、レベルを1段増やして記述します。リスト構造の子要素にする場合はレベルを1段増やさずに記述します。
- 引用文は、他のブロック要素を子要素にすることができます。引用文の子要素となるリスト構造はレベルを1段増やさずに記述します。
- リスト構造内の引用文から脱出する場合で、リスト構造を継続する場合は、<、<<、<<<を行頭に記述します。
リスト構造 †
-インライン要素
行頭で - を指定すると、番号なしリストになります。番号なしリストは -、--、--- の3レベルあります。
- 番号なしリストは、他のブロック要素の子要素になることができます。他のリスト構造の子要素にする場合は、レベルを1段増やして記述します。引用文の子要素にする場合は、レベルを増やさずに記述します。
- -の直後に ~を記述すると段落を子要素にすることができます。
- 番号なしリストは、リストの先頭がインライン要素または段落である場合に限り、リストの次の行に他のブロック要素を記述することで、他のブロック要素を子要素にすることができます。
+インライン要素
行頭で + を指定すると、番号付きリストになります。番号付きリストは +、++、+++ の3レベルあります。
- 番号付きリストは、他のブロック要素の子要素になることができます。他のリスト構造の子要素にする場合は、レベルを1段増やして記述します。引用文の子要素にする場合は、レベルを増やさずに記述します。
- +の直後に ~を記述すると段落を子要素にすることができます。
- 番号付きリストは、リストの先頭がインライン要素または段落である場合に限り、リストの次の行に他のブロック要素を記述することで、他のブロック要素を子要素にすることができます。
:定義語|説明文
行頭を : で始め、| 記号で区切ると、定義リストになります。定義リストは :、::、::: の3段階あります。定義リストの定義語、説明文は省略することができます。複数の連続した定義リストを記述し、2つ目以降の定義語を省略することで1つの定義語に対する複数の説明文を記述することができます。
- 行中に | がないと定義リストにはなりません。
- 定義語・説明文は、インライン要素のみ記述することができます。
- 定義リストは、他のブロック要素の子要素になることができます。他のリスト構造の子要素にする場合は、レベルを1段増やして記述します。引用文の子要素にする場合は、レベルを増やさずに記述します。
- |の直後に ~を記述すると段落を子要素にすることができます。
- 定義リストは、定義リストの次の行に他のブロック要素を記述することで、他のブロック要素を子要素にすることができます。
整形済みテキスト †
行頭が半角空白で始まる行は整形済みテキストとなります。行の自動折り返しは行なわれません。
- 整形済みテキストは、他のブロック要素の子要素になることができます。
- 整形済みテキストは、他のブロック要素を子要素にすることができません。
- 整形済みテキストは、すべての子要素を文字列として扱います。
表組み †
|インライン要素|インライン要素|
行頭から | でインライン要素を区切ることで表組みになります。
- 表組みは、他のブロック要素の子要素になることができます。
- 表組みは、他のブロック要素を子要素にすることができません。
CSV形式の表組み †
,データ,データ,…
行頭でカンマ(.)を記述し、インライン要素をカンマ区切りで記述すると表組みになります。
- インライン要素はダブルクォーテーション(")で囲むことができます。ダブルクォーテーションで囲むことで、カンマ(,)を含むインライン要素を記述できます。
- ダブルクォーテーション(")で囲んだデータの中で、ダブルクォーテーションを2つ("")続けることで、ダブルクォーテーション(")を含むインライン要素を記述できます。
- インライン要素の代わりにイコールを2つ(==)記述すると、colspanを意味します。
- インライン要素の左に1つ以上の半角空白文字を記述すると右寄せに、インライン要素の左右に1つ以上の半角空白文字を記述するとセンタリングになります。
- 表組みは、他のブロック要素の子要素になることができます。
- 表組みは、他のブロック要素を子要素にすることができません。
見出し †
*インライン要素
行頭で * を記述すると、見出しになります。見出しは *、**、*** の3段階あります。
- 見出しは、他のブロック要素の子要素になることはできません。見出しが現われると他のブロック要素は終了します。
- 見出しは、他のブロック要素を子要素にすることはできません。
目次 †
#contents
行頭で#contensを記述すると、見出しに基づいて目次を作成します。一般的に#contentsはページの最初のほうに記述します。
- 目次は、他のブロック要素の子要素になることができますが、トップレベルに設置することを前提に左マージンを設定してありますので、他のブロック要素の子要素にはしないでください。
- 目次は、他のブロック要素を子要素にすることはできません。
左寄せ・センタリング・右寄せ †
LEFT:インライン要素
CENTER:インライン要素
RIGHT:インライン要素
行頭でLEFT:、CENTER:、RIGHT:を記述すると、インライン要素が左寄せ、センタリング、右寄せされます。
- LEFT:、CENTER:、RIGHT:は、他のブロック要素の子要素になることができます。
- LEFT:、CENTER:、RIGHT:は、他のブロック要素を子要素にすることができません。
水平線 †
----
行頭で4つの - を書くと水平線になります。
- 水平線は、他のブロック要素の子要素になることはできません。水平線が現われると他のブロック要素は終了します。
- 水平線は、他のブロック要素を子要素にすることはできません。
#hr
行頭で#hrを記述すると、区切り線になります。区切り線は上位のブロック要素の幅の60%の長さの水平線がセンタリングされて引かれます。
- 区切り線は、他のブロック要素の子要素になることができます。
- 区切り線は、他のブロック要素を子要素にすることはできません。
行間開け †
#br
行頭で#brを記述すると、ブロック要素間またはブロック要素内で行間を開けることができます*1。
- 行間開けは、他のブロック要素の子要素になることができます。
- 行間開けは、他のブロック要素を子要素にすることはできません。
添付ファイル・画像の貼り付け †
#ref(添付ファイル名)
#ref(ファイルのURL)
行頭で#refを記述すると、添付ファイルまたは指定されたURLにあるファイルへのリンクを貼り付けることができます。ファイルが画像ファイルの場合は、その画像を表示します。
- #refには、カンマで区切って下記のパラメタを指定できます。パラメタを省略した場合はデフォルト値となります。
添付ファイルのページ
- 添付ファイルが存在するページ名を指定します。デフォルトは現在のページです。
- このパラメタを指定する場合は、添付ファイル名の次に記述します。
left
center
right
- ファイルへのリンク・画像を表示する位置を指定します。デフォルトではセンタリングされます。
wrap
nowrap
- ファイルへのリンク・画像を枠で囲むかどうかを指定します。デフォルトは囲みません。
around
- テキストの回り込みを指定します。デフォルトでは回り込みを行ないません。
nolink
- デフォルトでは添付ファイルへのリンクが張られますが、nolinkを指定するとリンクを張りません。
代替文字列
- ファイル名の代わりに表示する文字列や画像の代替文字列を指定できます。指定しない場合は、ファイル名になります。
- 代替文字列には文字列以外のインライン要素を含めることはできません。ページ名、文字列以外のインライン要素を記述しても文字列として扱われます。
- このパラメタを指定する場合は、最後に記述します。
- #refは、他のブロック要素の子要素になることができます。
- #refは、他のブロック要素を子要素にすることはできません。
テキストの回り込みの解除 †
#clear
行頭で#clearを記述すると、#refで指定したテキストの回り込みを解除します。#clearを指定しなくても、記事の末尾でテキストの回り込みが自動的に解除されます。
- #clearは、他のブロック要素の子要素になることができます。
- #clearは、他のブロック要素を子要素にすることができません。
#img(,clear)
#clearと同じ。
フォーム †
#comment
行頭で#commentを記述すると、コメントを挿入するためのフォームが埋め込まれます。
- #commentは、他のブロック要素の子要素になることができますが、トップレベルに設置することを前提に左マージンを設定してありますので、他のブロック要素の子要素にはしないでください。
- #commentは、他のブロック要素を子要素にすることはできません。
#pcomment
行頭で#pcommentを記述すると、コメントを挿入するためのフォームが埋め込まれます。#commentとは異なり、コメントは別ページに記録されます。また、コメントに対するレスポンスを階層状に表示します。
- #pcommentは、他のブロック要素の子要素になることができますが、トップレベルに設置することを前提に左マージンを設定してありますので、他のブロック要素の子要素にはしないでください。
- #pcommentは、他のブロック要素を子要素にすることはできません。
#article
行頭で#articleを記述すると、簡易掲示板のフォームが埋め込まれます。
- #articleは、他のブロック要素の子要素になることができますが、トップレベルに設置することを前提に左マージンを設定してありますので、他のブロック要素の子要素にはしないでください。
- #articleは、他のブロック要素を子要素にすることはできません。
#vote(選択肢1,選択肢2,...)
行頭で#voteを記述すると、簡易投票フォームが埋め込まれます。
- 選択肢は文字列、ページ名、InterWiki、リンクを含めることができます。その他のインライン要素を含めることができません。
- #voteは、他のブロック要素の子要素になることができますが、トップレベルに設置することを前提に左マージンを設定してありますので、他のブロック要素の子要素にはしないでください。
- #voteは、他のブロック要素を子要素にすることはできません。
インライン要素 †
- インライン要素は、必ずブロック要素の子要素になっています。
- 行頭書式でブロック要素を明示しない場合は、段落の子要素となります。
- 行頭書式でブロック要素を明示した場合は、指定したブロック要素の子要素になります。
- インライン要素は、インライン要素を子要素にすることができます。
- インライン要素はブロック要素を子要素にすることはできません。
- インライン要素となるプラグイン及びユーザー定義は&〜の形式になっています。
文字列 †
文字列
文字列はインライン要素です。
- 文字列は、他のインライン要素の子要素になることができます。
- 文字列は、他のインライン要素を子要素にすることができません。
改行 †
インライン要素~
行末に~を書くと行末改行になります。行末改行はブロック要素内での改行になります。
- 行末改行の次の行の行頭書式は無効になり、文字列として扱われます。
- 行末改行は、他のインライン要素の子要素になることはできません。
- 行末改行は、他のインライン要素を子要素にすることはできません。
- 行末改行は、定義リストの定義語、表組みの要素、#で始まるブロック要素のパラメタの中では使用できません。
&br;
行中に&br;書くと行中改行になります。行末の ~と違い、定義リストの定義語や表組の要素、#で始まるブロック要素のパラメタの中でも使用できます。
- 行中改行は、他のインライン要素の子要素になることができます。
- 行中改行は、他のインライン要素を子要素にすることはできません。
強調・斜体 †
''インライン要素''
行中のインライン要素を '' ではさむと、インライン要素が強調表示になります。
- 強調は、他のインライン要素の子要素になることができます。
- 強調は、他のインライン要素を子要素にすることができます。
'''インライン要素'''
行中のインライン要素を ''' ではさむと、インライン要素が斜体表示になります。
- 斜体は、他のインライン要素の子要素になることができます。
- 斜体は、他のインライン要素を子要素にすることができます。
文字サイズ †
&size(サイズ){インライン要素};
行中に&sizeを書くとインライン要素の文字サイズを指定することができます。サイズはピクセル単位(px)で指定します。
- 文字サイズは、他のインライン要素の子要素になることができます。
- 文字サイズは、他のインライン要素を子要素にすることができます。
文字色 †
&color(文字色,背景色){インライン要素};
行中に&colorを書くとインライン要素の文字色と背景色を指定することができます。背景色は省略できます。
- 色の指定は、次のいずれかの形式で行ないます。
- 文字色は、他のインライン要素の子要素になることができます。
- 文字色は、他のインライン要素を子要素にすることができます。
取消線 †
%%インライン要素%%
行中のインライン要素を%%ではさむと、インライン要素に取消線が付きます。
- 取消線は、他のインライン要素の子要素になることができます。
- 取消線は、他のインライン要素を子要素にすることができます。
注釈 †
((インライン要素))
行中でインライン要素を((と))ではさむと、注釈が作成され、行中に注釈へのリンクが貼られます。注釈文の中では注釈を使用できません(ネストはできません)。
- 注釈は、他のインライン要素の子要素になることができます。親要素は注釈文ではなく、注釈へのリンクに反映されます。
- 注釈は、他のインライン要素を子要素にすることができます。子要素は注釈文に反映されます。
添付ファイル・画像の貼り付け †
&ref(添付ファイル名);
&ref(ファイルのURL);
行中で&refを記述すると、添付ファイルまたは指定されたURLにあるファイルへのリンクを貼り付けることができます。ファイルが画像ファイルの場合は、その画像を表示します。
- &refには、カンマで区切って下記のパラメタを指定できます。パラメタを省略した場合はデフォルト値となります。
添付ファイルのページ
- 添付ファイルが存在するページ名を指定します。デフォルトは現在のページです。
- このパラメタを指定する場合は、添付ファイル名の次に記述します。
nolink
- デフォルトでは添付ファイルへのリンクが張られますが、nolinkを指定するとリンクを張りません。
代替文字列
- ファイル名の代わりに表示する文字列や画像の代替文字列を指定できます。指定しない場合は、ファイル名になります。
- 代替文字列には文字列以外のインライン要素を含めることはできません。ページ名、文字列以外のインライン要素を記述しても文字列として扱われます。
- このパラメタを指定する場合は、最後に記述します。
- &refは、他のインライン要素の子要素になることができます。
- &refは、他のインライン要素を子要素にはできません。
ルビ構造 †
&ruby(ルビ){インライン要素};
行中で&rubyを書くとインライン要素に対するルビをふることができます。ルビに対応していないブラウザではルビが本文中に ( と ) に囲まれて表示されます。
- ルビ構造のルビにはインライン要素を記述します。ただし、ルビの特性上、期待通りの表示になるとは限りません。
- ルビ構造は、他のインライン要素の子要素になることができます。
- ルビ構造は、他のインライン要素を子要素にすることができます。
- ルビ構造をルビ構造の子要素にはできません(ネストはできません)。
- 注釈内や文字サイズを小さくしている部分での使用は、ルビが判読できなくなるので避けてください。
アンカーの設定 †
&aname(アンカー名);
&aname(アンカー名){インライン要素};
行中で&anameを記述するとリンクのアンカーを設定することができます。リンクの飛び先にしたい位置に記述します。
- アンカー名は、半角アルファベットから始まる半角アルファベット・数字・ハイフン・アンダースコアからなる文字列を指定します。
- アンカー名の中には、全角文字や半角空白文字、半角記号を含めることはできません。
- アンカー設定は、他のインライン要素の子要素になることができます。
- アンカー設定は、他のインライン要素を子要素にすることができます。
カウンタ表示 †
&counter;
&counter(オプション);
行中で&counterを記述するとそのページにアクセスした人の数を表示することができます。
- &counterには次のオプションを指定できます。オプションを省略した場合はallが指定されたものとみなされます。
today
yesterday
all
- カウンタ表示は、他のインライン要素の子要素になることができます。
- カウンタ表示は、他のインライン要素を子要素にはできません。
オンライン表示 †
&online;
行中で&onlineを記述すると現在アクセス中の人数を表示することができます。
- オンライン表示は、他のインライン要素の子要素になることができます。
- オンライン表示は、他のインライン要素を子要素にはできません。
バージョン表示 †
&version;
行中で&versionを記述するとPukiWikiのバージョンを表示することができます。
- バージョン表示は、他のインライン要素の子要素になることができます。
- バージョン表示は、他のインライン要素を子要素にはできません。
WikiName
行中で、1つ以上の大文字→1つ以上の小文字→1つ以上の大文字→1つ以上の小文字の組合わせからなる半角//文字列はWikiNameになります。
ページ名 †
[[ぷきうぃき]]
行中で[[と]]で囲まれた文字列はページ名になります。
- ページ名の中には、全角文字、記号、数字、半角空白文字を含めることができます。
- ページ名の中には、"#&<>を含めることはできません。
- すでに存在するページであればそのページへのリンクが自動的に貼られます。存在しない場合はページ名の後ろに?が自動的に付き、そのページを新規作成するためのリンクが貼られます。
ページ名にアンカー名をつけることもできます。
[[ページ名#アンカー名]]
- ページ名は、他のインライン要素の子要素になることができます。
- ページ名は、他のインライン要素を子要素にはできません。
[[InterWikiName:ページ名]]
行中のページ名形式の文字列の中で、:で2つの文字列を区切るとInterWikiになります。:の前にはInterWikiNameのページで定義したInterWikiNameを、:の後ろにはページ名を記述します。
ページ名の後ろにアンカー名をつけることもできます。
[[InterWikiName:ページ名#アンカー名]]
リンク †
[[リンク名:URL]]
行中のInterWikiNameの形式の文字列の中で、:の前に任意のリンク名を、:の後ろにURLを記述すると、そのリンク名でURLに対するリンクを貼ることができます。
行中に直接、URLを記述した場合は自動的にそのURLに対するリンクが貼られます。
記述したURLが画像ファイルである場合は、その画像を表示します。
- リンクは、他のインライン要素の子要素になることができます。
- リンクは、他のインライン要素を子要素にはできません。
エイリアス †
[[エイリアス名>ページ名]]
行中のページ名形式の文字列の中で、>で2つの文字列を区切るとエイリアスになります。>の前にはエイリアス名を、>の後ろにはページ名を記述します。
エイリアスはPukiWiki内のページ名とは別のエイリアス名で、指定したページへのリンクを貼ります。
ページ名にアンカー名を付け加えてアンカーへのリンクを貼ることができます。ページ名とアンカー名の間には#をつけます。カレントページのアンカーへリンクを貼る場合はページ名を省略することができます。
[[エイリアス名>ページ名#アンカー名]]
[[エイリアス名>#アンカー名]]
エイリアスをURLやInterWikiと組み合わせることもできます。URLを指定する場合は、>の代わりに:も使用できます。
[[エイリアス名>http://www.example.com/]]
[[エイリアス名>https://www.example.com/]]
[[エイリアス名>ftp://ftp.example.com/]]
[[エイリアス名>news://news.example.com/]]
[[エイリアス名>foo@example.com]]
[[エイリアス名>InterWikiName:ページ名]]
[[エイリアス名>InterWikiName:ページ名#アンカー名]]
[[エイリアス名:http://www.example.com/]]
[[エイリアス名:https://www.example.com/]]
[[エイリアス名:ftp://ftp.example.com/]]
[[エイリアス名:news://news.example.com/]]
[[エイリアス名:foo@example.com]]
- エイリアス名の中には、全角文字を含めることができます。
- エイリアス名の中には、半角空白文字を含めることができます。
- 階層化されたページでは、ページ名を相対指定することができます。
- エイリアスは、他のインライン要素の子要素になることができます。
- エイリアスは、他のインライン要素を子要素にできます。
タブコード †
&t;
行中で&t;と書くと、タブコードに置換されます。
通常、フォーム内ではキーボードからタブコードを直接入力できない*2ので、タブコードを入力したい位置に&t;を記述すると、保存時にタブコードに置換します。
- タブコードは、記事が書き込まれるときに置換されて記録されます。
- タブコードは、他のインライン要素の子要素になることができます。
- タブコードは、他のインライン要素を子要素にはできません。
ページ名置換文字 †
&page;
&fpage;
行中で&page;及び&fpage;と書くと、編集中のページ名に置換されます。ページ名が階層化されたページで「hogehoge/hoge」となっている場合、&page;は「hoge」に、&fpage;は「hogehoge/hoge」に置換されます。階層化されていないページでは、&page;も&fpage;も同じになります。
- ページ名置換文字は、記事が書き込まれるときに置換されて記録されます。
- ページ名置換文字は、他のインライン要素の子要素になることができます。
- ページ名置換文字は、他のインライン要素を子要素にはできません。
日時置換文字 †
&date;
&time;
&now;
行中で&date;と書くと、更新時の日付に置換されます。
行中で&time;と書くと、更新時の時刻に置換されます。
行中で&now;と書くと、更新時の日時に置換されます。
PukiWiki 1.3系との後方互換性のために下記のものも使用できるようにしてあります。
行中で&_date;と書くと、表示時の日付に置換されます。
行中で&_time;と書くと、表示時の時刻に置換されます。
行中で&_now;と書くと、表示時の日時に置換されます。
行中で&lastmod;と書くと、そのページの最終更新日時に置換されます。
- &_date;、&_time;、&_now;、&lastmod;は、記事が表示されるときに置換されて表示されます。
- &_date;、&_time;、&_now;、&lastmod;は、他のインライン要素の子要素になることができます。
- &_date;、&_time;、&_now;、&lastmod;は、他のインライン要素を子要素にはできません。
文字参照文字 †
文字参照は、SGMLで定義されている文字参照文字(©や®など)のほか、下記の独自の文字参照文字が使用できます。
&heart;
行中で&heart;と書くと、ハートマーク ![[heart]](image/face/heart.png)
に置換されて出力されます。
- 文字参照文字は、表示されるときに置換されます。
- 文字参照文字は、他のインライン要素の子要素になることができます。
- 文字参照文字は、他のインライン要素を子要素にはできません。
数値参照文字 †

進数;
進数;
行中で&#と ;の間に10進数を、&#xと ;の間に16進数を書くと、Unicodeを数値参照して表示します。キーボードから直接入力できない文字やJIS第3水準・第4水準の文字などの表示に使用します。たとえば、内田百閒と入力すると、内田百閒と表示されます。
- 数値参照文字は、表示されるときに置換されます。
- 数値参照文字は、他のインライン要素の子要素になることができます。
- 数値参照文字は、他のインライン要素を子要素にはできません。
- 16進数は半角小文字で指定する必要があります(XHTML 1.0 第2版から小文字に限定されました)。
その他 †
コメント行 †
// コメント
行頭で // を指定すると、コメント行になります。コメント行は出力されない行です。
- コメント行は、他の要素と無関係に行単位でどの位置にも記述できます。
- コメント行は、前後の他の要素に何ら影響を及ぼしません。
![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
