This page is a tutorial for using the wiki image-formatting syntax available starting with MediaWiki 1.2 (upgraded in March 2004). The image markup is backwards-compatible, so old instances of images do not need to be upgraded – they already meet the current standards. However, there are a number of additional features available to make the presentation of images in an article cleaner and more attractive.
Basic syntaxThe basic format for displaying an image inline is
[[File:Image name.ext|<style options>|Caption text]]
- thumbnail, thumb
- Generates an automatically re-sized thumbnail image, normally on the right, with the caption text displayed directly underneath. An "enlarge" icon is added. Example: [[File:Moon.jpg|thumbnail|The Moon]]
- The image will have a frame, regardless of whether it is a thumb, and the caption text will be included as a visible caption.
- Makes the image right-aligned; can be used with and without specifying "thumb"
- Same as above, but left-aligned.
- The image will be rendered inline, even if the thumbnail option is set
- Render a thumbnail version of the image that is [size] pixels wide (e.g. "150px"). Height is computed to maintain the aspect ratio (i.e. the shape of the image). Specifying this overrides the preferred thumbnail size set in user preferences, so do not use this option except on list articles, when it must be set to 150px.
Vertical bars (the pipe "|" character) are used to separate options from each other and from the caption text. Unknown options are ignored and the final parameter is used as the caption text. Note that the caption text should describe the image and should not end with a period, as in the examples above.
Images can be linked to without displaying the image by putting a colon in front of the image link, like this: [[:File:Uchu cover.jpg]] which is displayed as: File:Uchu cover.jpg. These can also use pipes like standard links, like this: [[:File:Uchu cover.jpg|text here]].