Text is basically displayed as you typed, but there are several special formatting rules. This page is a summary of the most frequently used formatting rules.

Inline Elements

Text Decorations and Special Entities

Format exampleCodeComment
Emphasised text''Emphasised text''(two single quotes)
Italic text'''Italic text'''(three single quotes)
Strikethrough text%%Strikethrough text%%
Underlined text%%%Underlined text%%%

eak�is�insertedhere.|A line break is inserted&color(foreground[,background]){text};here.|Inserts a line break.|

Font size 24&size(px){Text you want to change};Font size 24&color(red){};
Purple text&color(foreground[,background]){text};Purple text&color(red){};See Web Color Reference.
Colored text&color(foreground[,background]){text};Colored text&color(red){};See Web Color Reference.
Yellow text in blackblackYellow text in black&color(red){};See Web Color Reference.
*1((Footnote text))Footnote number is inserted inline.Footnote text is inserted at the end of the page.
<i>Not Italic</i><i>Not Italic</i>HTML tags don't work.
&��²&��²Character entity reference works.
"@☎漢字"@☎漢字Number entity reference works.
FormattingRules&color(foreground[,background]){text};Inserts the current page name.

Embedding Images and Files

Format exampleCodeComment
You can attach a file to a Wiki page by clicking [Attach] at the top of the page.
sample.jpg&ref(./sample.jpg);Inserts an image attached to the current page.
sample.jpg&ref(Page Name/sample.jpg);Inserts an image attached to another page.
sample.jpg&ref(http://www.example.com/sample.jpg);Inserts an external image.
filesample.zip&ref(./sample.zip);Inserts a download link if the target isn't an image.
sample.zip&ref(./sample.zip,noicon);Shows no download icon.
filesample.jpg&ref(./sample.jpg,noimg);Inserts a download link even if the target is an image.
sample.jpg&ref(./sample.jpg,nolink);Inserts no link for the original image.
sample.jpg&ref(./sample.jpg,60x40);Width x Height
This is a sample.&ref(./sample.jpg,This is a sample);Alternative text


Format exampleCodeComment
WikiNameWikiNameWikiName is a string starts with capital letter(s)+small letter(s)+capital letter(s)+small letter(s) and contains no space. By default, WikiName is automatically linked to the Wiki page of the same name, or shows a ? to make a new page if the page doesn't exist. This function can be disabled by the administrator. See the last section of Help.
Page Name[[Page Name]]BracketName is a page name enclosed between [[ and ]]. BracketName is automatically linked to the Wiki page as well as WikiName. A page name can contain spaces and have no restrictions for capitalization, but can't contain ", #, &, < and >.
Page Name#anchor[[Page Name#anchor]]You can include an anchor to a page name.
&aname(anchor);Inserts an anchor.Headings automatically generate an anchor like [#vfad867b].
Alias[[Alias>Page Name]]Inserts a link to a Wiki page with an alias.
sample.jpg[[&ref(): File not found: "%%%sample.jpg&color(red" at page "};%%%.";Page Name&color(red){]]Inserts a link to a Wiki page with an attached image.
sample.jpg[[http://www.example.com/sample.jpg>Page Name]]An external image can be used instead.
http://www.example.comhttp://www.example.comA url is automatically linked.
sample.jpghttp://www.example.com/sample.jpgA url to an image displays the image.
Site Name[[Site Name:http://www.example.com]]Inserts an external link with a text.
Page Name[[Page Name:<paste the url here>]]An easy way to link any heading of PukiWiki pages. Click in the heading and copy the url from browser's address window.
sample.jpg[[&ref(): File not found: "%%%sample.jpg&color(red" at page "};%%%.";http://www.example.com&color(red){]]Inserts an external link with an attached image.

Block Elements

A block element continues until another block element or a blank line appears. There needs a blank line between two paragraphs, but if the next block isn't a paragraph (ie. starting with a special character), it's clear it's a new block and no blank line is necessary.

PukiWiki ignores any unnecessary blank lines, so you can insert some to make the source readable. Because more than one blank line insert no additional vertical space between block elements, you have to use '''' to insert more vertical space.


A new line starts a paragraph, unless it starts with a special character like *, >, +, -, #, etc.

A new line starts with ~ explicitly starts a new paragraph. The letter ~ itself isn't shown and escapes the next special character including itself, if any.

By default, pressing Enter doesn't make a new line within a paragraph. To make a new line, insert ~ at the end of the line, or insert '''' anywhere in the line. This behavior can be changed by the administrator. See the last section of Help.

A new line starts with RIGHT: starts a new paragraph alined to right, and a new line starts with CENTER: starts a new paragraph alined to center.

Preformatted text

A new line starts with a space makes preformatted text. Preformatted text is displayed in a light blu
e box with a monospaced font. Line breaks aren't automatically inserted, and all formatting rules are ignored in preformatted text.


This line starts with a space.


A new line starts with *, **, *** makes Heading level 1, 2, 3 respectively. In this page, the heading Block Elements is Heading level 1 and the heading Headings is Heading level 2.

Headings are also used in #contents plugin to make the table of contents.


A new line starts with >, >>, >>> makes Quote level 1, 2, 3 respectively.


Quote Level 1

Quote Level 2

Quote Level 3


A new line starts with -, --, --- makes Unordered list level 1, 2, 3 respectively.


  • Unordered list level 1
    • Unordered list level 2
      • Unordered list level 3

A new line starts with +, ++, +++ makes Ordered list level 1, 2, 3 respectively.


  1. Ordered list level 1
    1. Ordered list level 2
      1. Ordered list level 3

A new line starts with :Definition|Description makes Difinition list. Any of difinition and description can be omitted.


Definition 1
Description 1
Definition 2
Description 2


A new line starts with // is treated as a comment line and ignored.

Horizontal line

A new line starts with four dashes (----) or more inserts a horizontal line.



Example 1


Example 2

|RIGHT:100|CENTER:|SIZE(20)|c -------------- format definition line
|~Header|Header2|Header3|h ----------------- header line
|footer|>|CENTER:colspan|f ----------------- footer line

*1 Footnote text

Front Page   Edit Diff Backup Attach Copy Rename Reload   New All Pages Search Recent Changes   Help   RSS of recent changes