There are five types of links in MediaWiki:

  1. Internal links to other pages in the wiki
  2. External links to other websites
  3. External links to internal pages in the wiki
  4. Interwiki links to other websites registered to the wiki in advance
  5. Interlanguage links to other websites registered as other language versions of the wiki

In this document we will discuss the first two. Further documentation can be found here.

Internal links

To add an internal link, enclose the name of the page you want to link to in double square brackets. When you save the page, you'll see the new link pointing to your page. If the page exists already it is displayed in blue, if it does not, in red. Selflinks to the current page are not transformed in URLs but displayed in bold. (If you really want to link to the current page, use an anchor (see below), or [[#top|current page]] which always links to the top.)

The first letter of the target page is automatically capitalized, unless otherwise set by the admins, and spaces are represented as underscores (typing an underscore in the link will have a similar effect as typing a space, but is not recommended, since the underscore will also be shown in the text).


Description You type You get
Internal link
[[Main Page]]
Main Page
Piped link
[[Main Page|different text]]
different text
Pipe trick
[[Help:Contents|]]

[[User:John Doe|]]

[[Extension:DynamicPageList (Wikimedia)|]]

[[Extension:DynamicPageList (third-party)|]]
The pipe trick quickly makes shorter link text, but could be confusing in circumstances like the DynamicPageList link examples.
Contents

John Doe

DynamicPageList

DynamicPageList

Word-ending links, following so called "linktrail rules".
[[Help]]s

[[Help]]ing

[[Help]]ers

[[Help]]almostanylettersyoulikehere

Helps

Helping

Helpers

Helpalmostanylettersyoulikehere

Avoiding word-ending links
[[Help]]<nowiki />ful advice

[[wikipedia:GNU General Public License|GPL]]<nowiki />v3

Helpful advice

GPLv3

Redirect
#REDIRECT [[Main Page]]
Main Page
Internal link to an anchor
[[#See also]]
Section headings and the top of the page are automatically anchored.
#See also
Internal link to an anchor from different text
[[#See also|different text]]
different text
Setting an internal link anchor
<div id="NameOfAnchorHere">optional text</div>
Omit the "optional text" for invisible anchor.
optional text
Internal link to an anchor at another page
[[Help:Images#Supported media types for images]]
Help:Images#Supported media types for images
Internal link to a subpage
[[/example]]

Shortcut for [[Help:Links/example|/example]].

See also Help:Subpages.
/example
Internal link to a subpage without the leading slash
[[/example/]]

Shortcut for [[Help:Links/example|example]].

example
Internal link to a category page
[[:Category:Help]]
Category:Help
Internal link to an image or a file of other types
[[media:example.jpg]]

[[media:example.pdf]]
See also Help:Images
media:example.jpg

media:example.pdf

Internal link to the user's user page
[[Special:MyPage]]
Special:MyPage
Internal link to the user's talk page
[[Special:MyTalk]]
Special:MyTalk

External links

To add an external link, enclose the URL followed by space and the name of the page you want to link to in single square brackets. When you save the page, you'll see the new link pointing to your page, with an arrow icon after it to show that it was coded with single bracket external link syntax, and thus may lead to another site.

Description You type You get
External link http://mediawiki.org http://mediawiki.org
External link with different label [http://mediawiki.org MediaWiki] MediaWiki
Numbered external link [http://mediawiki.org] [1]
External links with file icons [http://en.wikipedia.org/wiki/.avi video] [http://en.wikipedia.org/wiki/.ogg sound] [http://en.wikipedia.org/wiki/.pdf document]

video
sound
document

Mailto link [mailto:info@example.org email me] email me
Mailto named with subject line and body [mailto:info@example.org?Subject=URL%20Encoded%20Subject&body=Body%20Text info] info