For more detailed information on links, including inter-wiki and inter-language links see the generic mediawiki links topic: Help:Links.
Linking to articles
The Insert Link dialog then allows you to enter the target page name (using an auto-complete field), optional text to display instead of the target page name, and whether the link is internal (to another wiki page) or external (to a URL).
When you press the Insert Link button on the dialog the appropriate wiki text for the link is added to the page.
If you want to edit the link manually, then the Wiki Editor provides basic help on the formatting for both external and internal links in the "Help" section, as shown in the figure above, or you can copy the syntax below. Note that you can do all of these formats in the Wiki Editor, except for linking to a specific heading in a page.
|Internal link||[[Target Page Name]]||Target Page Name|
|Internal link (with link display text)||[[Target Page Name|Link Text to Display]]||Link Text to Display|
|Internal link to heading in page||[[Target Page Name#Target heading name|Link Text to Display]]||Link Text to Display|
|External link (bare format)||http://www.beer.com||http://www.beer.com|
|External link (no name)||[http://www.beer.com]|||
|External link (with link display text)||[http://www.beer.com Beer.com]||Beer.com|
Linking to files
Files can be linked to using the same internal link syntax as any other page. Note however that if you want to specify link text other than the filename then you need to add a preceding colon (":") before the "File" namespace, as shown below:
|File link (with different display text)||[[:File:NotifierExample.zip|Notifier UI]]||Notifier UI|
|Download file (bypass file page)||[[Media:NotifierExample.zip|Notifier UI]]||Notifier UI|
Linking to images
To link to images you must use a colon preceding the namespace (as discussed above) or the image itself will be displayed instead of the link. Examples of the right and wrong way shown below
|File link (incorrect)||[[File:insert-link.png]]|
|File link (correct)||[[:File:insert-link.png]]||File:insert-link.png|
|File link (correct, with new link text)||[[:File:insert-link.png|Image link text]]||Image link text|
- Not putting space after a bare link. This fails because the URL includes any attached characters. It isn't always obvious on inspection either, for example when a link is followed by a comma, braces or characters in other languages. For example, the following all fail:
- http://www.symbian.com(Symbian signed)
- Putting an additional bracket around the external link format. This works, but you end up with an unnecessary bracket. For example:
- [[http://www.symbian.com Symbian Signed]] renders as [Symbian Signed]
- Putting your link inside a Note, Tip, Warning or InfoBox can break it if the URL contains the equals (=) or pipe (|) characters. If this is the case you must replace it with their HTML entities (= and |, respectively) or HTML encoded values (%3D and %7C, respetively).