View source for Help:Link

{{Short description|Wikimedia help page}}
{{pp-semi-indef|small=yes}}
{{Redirect|H:L|help with lists|Help:List}}
{{About|how to mark up links|a very basic tutorial|Project:Tutorial/{{SITENAME}} links|various URLs of {{SITENAME}} and other Wikimedia servers|Help:URL}}
{{{{SITENAME}} how to|H:L|H:LINK}}
{{Linking and page manipulation|linking and diffs}}
[[File:How to make a wikilink.webm|thumb|300px|A video screencast showing how to create wikilinks]]
This page explains how to make the '''wikilink''', '''interwiki link''', or external '''web link''' (as [[hyperlink]]s) connections on {{SITENAME}}, which gives readers one-click access to other {{SITENAME}} pages, other Wikimedia projects, and external websites.

A link has various (changeable) appearances on the "anchor" page, and the "target" page, which owns the "backlinks", and which can count the links to it with the ''[[WP:What links here]]'' tool.

For a short list of some basic shortcuts, see [[Project:Cheatsheet]].

For guidelines on how links should be used in {{SITENAME}}, see [[Project:Manual of Style/Linking]].

== <span id=Wikilinks>Wikilinks (internal links)</span> ==
{{see also|Project:Manual of Style/Linking|Help:Wikitext#Wikilinks|mw:Help:Links}}
{{shortcut|H:WIKILINK}}
A wikilink (or internal link) is a link from one page to another page within the English {{SITENAME}}, or, more generally, within the ''same'' {{SITENAME}} (e.g. within the French {{SITENAME}}), in other words: within the same domain, or, even ''more'' generally, within the same Wikimedia project (e.g. within [[Wiktionary]]).

Links are enclosed in doubled square brackets:
* <code><nowiki>[[1234]]</nowiki></code> is seen as "[[1234]]" in text and links to (the top of) page "[[1234]]".
Use a [[vertical bar]] "|" (the "pipe" symbol) to create a link which appears as a term other than the name of the target page. Links of this kind are said to be "[[Help:Piped link|piped]]". The first term inside the brackets is the title of the page you would be taken to (the link target), and anything after the vertical bar is what the link looks like for the reader on the original page (the link label). For example:
* <code><nowiki>[[a|b]]</nowiki></code> appears as "[[b]]" but links to page "[[a]]", thus: [[a|b]].
See [[Help:Pipe trick]] for how to generate some common forms of piped links without typing text after the "|".

Letters and other non-punctuation text immediately (i.e. without a space) after the closing brackets of a wikilink becomes part of the label (meaning it is shown in the same colour as the label) without changing the target. This is useful for plurals and verb forms which only add something at the end. For example:

* <code><nowiki>[[apple]]s</nowiki></code> generates [[apple]]s, linking to [[apple]], and is equivalent to but more convenient than <code><nowiki>[[apple|apples]]</nowiki></code>.

This not only saves the active editor time, it also makes the code easier to read; the latter is why it is recommended wherever possible.

More complicated examples:

* <code><nowiki>[[a|b]]c</nowiki></code> gives [[a|b]]c, equivalent to <code><nowiki>[[a|bc]]</nowiki></code> .
* <code><nowiki>a[[b]]</nowiki></code> gives a[[b]]. There are no special rules for text preceding a wikilink.
*If you want the "a" in front in the colour of the link, you have to write<br/><code><nowiki>[[b|ab]]</nowiki></code> gives [[b|ab]].
* <code><nowiki>[[a]]:b</nowiki></code> gives [[a]]:b since the rule doesn't apply to punctuation.<br/>This does the right thing for possessives, like <code><nowiki>[[Batman]]'s</nowiki></code> gives [[Batman]]'s.
* <code><nowiki>[[a]]''b''</nowiki></code> gives [[a]]''b''. This rule also applies to "invisible" notation such as double apostrophes (to turn on and off italics) 
* Even italics ''in'' the link: <code><nowiki>[[a|a''b'']]</nowiki></code> gives [[a|a''b'']], but, of course, in colour.
* <code><nowiki>[[a]]&lt;nowiki /&gt;b</nowiki></code> gives [[a]]<nowiki/>b. The nowiki tag turns off the rule.
* <code><nowiki>[[a|b]]&lt;nowiki /&gt;c</nowiki></code> gives [[a|b]]<nowiki/>c.

The link target is ''case-sensitive except for the first character'' (so <code><nowiki>[[atom]]</nowiki></code> links to "[[Atom]]" but <code><nowiki>[[ATom]]</nowiki></code> does not, it links to a ''different'' page). 

If the target of a wikilink does not exist, it is displayed in a red color and is called a "[[Project:Red link|red link]]". Here is a [[red link example]]. 

To see what the tool tip tells you about a red link and what is displayed at the bottom left corner, move your mouse pointer into this red link.

If a red link is clicked, the user is taken to a blank page where it is possible to create a page using that red linked title. While on that blank page, other red links to this (non-existent) title can be detected using the "[[Help:What links here|What links here]]" feature.

If the target of a link is the same as the page on which it appears (a [[Help:Self link|self-link]]), it is displayed in bold font, as with: [[Help:Link]].  Yes, its wiki code is actually <code><nowiki>[[Help:Link]]</nowiki></code>. But it is not in the usual link colour, and it does not react as a link does; if the mouse pointer is in it, the mouse pointer looks like being in/over plain text.

When an edit is previewed before saving, if the target of a newly made link turns out to be a [[WP:DAB|disambiguation page]], such as the [[Peacemaker]] page, the link should be changed to one of the choices on that page unless the link is purposely in a [[WP:HN|hatnote]]. If necessary, the new link can be [[WP:pipe|pipe]]d, such as in {{code|<nowiki>[[Peacemaker (comics)|Peacemaker]]</nowiki>}}, which appears as [[Peacemaker (comics)|Peacemaker]] and links to the article about the fictional characters. Readers should not be directed to disambiguation pages unless there is no other option but to do so.

Attempting to link normally to an [[Project:Images|image]] page, [[Project:Categorization|category]] page or [[Help:Interlanguage links|interlanguage link]] will produce a different effect: this will respectively place the image on the page, add the page to the category, or create an interlanguage link at the edge of the page. To override this behavior, insert an initial colon ":", as in <code><nowiki>[[:File:Mediawiki.png]]</nowiki></code>, <code><nowiki>[[:Category:Help]]</nowiki></code>, <code><nowiki>[[:fr:Help:Link]]</nowiki></code>.

Less common ways in which link targets are reinterpreted are described below in [[#Conversion to canonical form]].

===Inserting and deleting internal links===
* When [[Project:Edit source|editing ''source'']], links are inserted or deleted simply by adding or removing pairs of square brackets enclosing the text concerned (plus handling piped links).

There are some helpful tools:
* When using the [[WP:visualEditor|visual editor]], selecting some text, then clicking the link icon above the text box (two links of a chain) will allow the link to be added, offering a selection of possible matches and the ability to pipe.
* When using the [[WP:WikEd|WikEd]] source editor, selectable from Preferences > Gadgets > Editing, there is a "Wiki link" button (typically the first button on the bottom row). When editing, if some text is [[Selection (user interface)|highlighted]], clicking the Wiki link button will enclose it in double brackets, i.e., Wikilink it. If, however, some text is highlighted that includes one or more internal links—in many cases just a single internal link with its delimiting brackets—they will be removed instead. For a single link without pipe, the Wiki link button will toggle between linking and unlinking.

== Interwiki links ==

{{See also|Help:Interwiki linking|meta:Help:Interwiki linking|Help:Interlanguage links}}

An [[Help:Interwiki linking|interwiki link]] links to a page on another Wikimedia project website, such as [[Meta-Wiki|Meta]] or another language {{SITENAME}}. The target site must be on the [[m:Interwiki map|interwiki map]] specified for the source wiki. These links have the same <nowiki>[[...]]</nowiki> syntax as wikilinks (see previously), but take a prefix ":x:" which specifies the target site.

For example, <code><nowiki>[[m:Help:Link]]</nowiki></code> links to the "Help:Link" page on Meta, while <code><nowiki>[[:commons:Athens]]</nowiki></code> links to page "Athens" on [[Wikimedia Commons]] as: [[:commons:Athens]].

Interwiki links can be piped, just as with wikilinks. Remember that an [[Help:Interlanguage links|interlanguage link]] should be preceded by a colon if it is to be displayed, where it is inserted in the text, as an [[Help:Interlanguage links#Inline links (links in the text of the article)|inline interlanguage link]]; otherwise it will be displayed in the list of interlanguage links at the side of the page (which is appropriate only if it is the most closely corresponding page in the other language {{SITENAME}}). Thus (incorporating the [[Help:Link#Pipe_trick|pipe trick]]), <code><nowiki>[[:ja:Wikilink|]]</nowiki></code> would be used to link to Wikilink on Japanese {{SITENAME}}. Example: (<code><nowiki>[[:ja:URL|]]</nowiki></code> links to [[:ja:URL|URL]] on Japanese {{SITENAME}}).

Interwiki links (like external links) are displayed in a slightly paler blue than ordinary wikilinks. The [[MediaWiki]] page formatting does not detect whether these target pages exist, so they are never displayed in red.

== <span id="External link">External links</span> ==
{{See|Project:External links}}
External links use [[URL]]s to link directly to any web page.  External links are enclosed in single square brackets (rather than double brackets as with internal links), with the optional link text separated from the URL by a space (not a "|" as with internal links).  When rendered, external links are followed by an [[Help:external link icons|external link icon]].  For example, 
::<code><nowiki>[http://www.example.org/&nbsp;link&nbsp;text]</nowiki></code> 
will be rendered as 
::[http://www.example.org/ link text].

The URL must be specified in full, including the protocol: for example <code><nowiki>[http://...]</nowiki></code> or <code><nowiki>[https://...]</nowiki></code>.  Short form URLs that are accepted in some other (non-Wikimedia) contexts like <code><nowiki>[example.org/&nbsp;link&nbsp;text]</nowiki></code> or <code><nowiki>[www.example.org/&nbsp;link&nbsp;text]</nowiki></code> are not accepted and will not result in a link being generated.  Instead, the link generating markup including the square brackets will be copied directly to the marked-up output, thus <nowiki>"[example.org/&nbsp;link&nbsp;text]"</nowiki> or <nowiki>"[www.example.org/&nbsp;link&nbsp;text]"</nowiki>.

When no link text is specified, external links appear numbered: <code><nowiki>[http://www.example.org/some-page][http://www.example.org/some-other-page]</nowiki></code> becomes [http://www.example.org/some-page][http://www.example.org/some-other-page]. Links with no square brackets display in their entirety: <code><nowiki>http://www.example.org/</nowiki></code> displays as http://www.example.org/.

For more detailed information on external linking practices, see {{section link|Help:URL|Linking to URLs}}. Also note that [[Special:LinkSearch]] can be used to find all pages linking to a given site.

The external link syntax can also be used to link to particular pages within {{SITENAME}} that are not accessible by wikilinks, such as [[Help:Page history|page history]], the edit view, an old version of a page, the [[WP:Diff|diff]] between two versions, etc. It can also be used to create a [[m: Help:Navigational image|navigational image]].

To display an external link without the arrow icon, place the external link syntax between <syntaxhighlight lang="html" inline><span class="plainlinks">...</span></syntaxhighlight> tags. For instance, <syntaxhighlight lang="html" inline><span class="plainlinks">[https://en.{{SITENAME}}.org/w/index.php?title=Help:Link&action=history this page's history]</span></syntaxhighlight> will be rendered as: <span class="plainlinks">[https://en.{{SITENAME}}.org/w/index.php?title=Help:Link&action=history this page's history]</span>. If you make frequent use of this, the [https://www.mediawiki.org/wiki/extension:CharInsert CharInsert] gadget (which can be activated under {{myprefs|Gadgets|Editing &rarr; CharInsert}}), has an option to insert this text in its "Wiki markup" mode.

=== <span id="Http: and https:">http: and https:</span> ===

[https://blog.wikimedia.org/2015/06/12/securing-wikimedia-sites-with-https/ In mid-2015], {{SITENAME}} and all other Wikimedia sites were changed to use [[HTTPS]] to encrypt all traffic.  Accessing a URL like <code>http://en.{{SITENAME}}.org/wiki/Help:Link</code> will result in the webserver redirecting you to <code>[https://en.{{SITENAME}}.org/wiki/Help:Link http<u>s</u>://en.{{SITENAME}}.org/wiki/Help:Link]</code>.  Therefore, when making an external-style link to an internal page (that is, using single square brackets, or a bare URL), <code>https</code> should be specified to avoid the needless redirect, as in <code>https://en.{{SITENAME}}.org/w/index.php?title=Help:Link&action=history</code>.

In the past, when {{SITENAME}} could be accessed via either HTTP or HTTPS, a [[WP:PRURL|protocol-relative URL]] could be used to make an external link (or external-style link to an internal page) which would use <code>http:</code> or <code>https:</code> depending on how the page the link appeared on was accessed, as in <code><nowiki>[//www.mediawiki.org/wiki/Help:Links]</nowiki></code>.  However, as all Wikimedia sites now require HTTPS, this linking style is obsolete and should no longer be used. <code>http:</code> or <code>https:</code> should be explicitly specified as appropriate for the target site (preferring <code>https:</code>, where available).

== What is an "anchor"? ==
{{sh|WP:ANCHOR DEF}}

The word "anchor" has two opposite meanings.

In the context of a link from an ''anchor'' to a ''target'', it is the starting place. 

In the context of the {{tl|anchor}} template, an "anchor" is a landing place for a link to jump to. The anchor ''template'' automatically creates some invisible coding from ''certain text in the template'' in the "landing place". In this context, the word "anchor" may refer to:
* the text and parameters, in the template, from which the invisible code is created,
* the mostly invisible HTML code, or
* the landing place/location/spot in itself.

== Section linking (anchors) ==
{{shortcut|WP:ANCHOR}}
{{see also|Help:Section#Section linking|Project:Manual of Style/Linking#Section links}}

To link to a section or subsection in another page, append a <code>#</code> and the section name to the page name: 
:{{nowrap|<code><nowiki>[[Page name#Section name|displayed text]]</nowiki></code>}}

For linking in the same page, omit the page name and use a <code>#</code> and the section name: 
:{{nowrap|<code><nowiki>[[#Section name|displayed text]]</nowiki></code>}}

Omitting the page name is recommended when linking to a section in the same page because the link will work as expected when previewing changes or after moving the page.

To format a link with the [[section sign]] (§) instead of a # (e.g. {{section link|Page name|Section name}} rather than [[Page name#Section name]]), use the template {{tl|Section link}} (or {{tl|slink}}):
:{{nowrap|<code><nowiki>{{Section link|Page name|Section name}}</nowiki></code>}}

Note that <code>Section names</code> are entirely case sensitive, in contrast to article links, where the first letter is not case sensitive.

The characters <code>[ ] { | }</code> require encoding when linking to a section:
{| class="wikitable"
! [ !! ] !! { !! <nowiki>|</nowiki> !! }
|-
| .5B || .5D || .7B || .7C || .7D 
|}
For example, the section "[Closed] Complaint" can be linked with <code><nowiki>[[#.5BClosed.5D Complaint]]</nowiki></code>. Links in the table of contents will automatically make this encoding, so the URL can be copied from there. However, that URL will also encode other characters which do not interfere with templates or wikicode, so the result may look ugly.

For more information, see [[Help:Section]]. See also {{slink|Project:Redirect|Targeted and untargeted redirects}}.

===Specifics===

When a link contains a section title (as in the examples above), the title actually points to an HTML ''[[HTML element#Anchor |anchor]]'' on the target page. In addition to anchors created automatically by section titles, there are times when it's advantageous to create an anchor on a smaller unit of text, such as a specific paragraph (see {{section link ||Linking to part of a section}} below). This can be done using {{tl2|Anchor|anchor name}}, or alternatively, the [[HTML]] code {{nowrap|<code><nowiki><span id="anchor name">...</span></nowiki></code>}} (see {{tl|Anchor}} syntax). Anchors are also used when renaming a section, yet still allowing links to the old name to function, or similarly, allowing linking to a section using an abbreviation; see [[MOS:HEADINGS]] for more info. Links to anchors can also be added to external URLs and to interwiki links, again using the <code>#</code> syntax.

Section links still work through page names that are [[Help:Redirect|redirects]]. For example, if [[Danzig]] redirects to [[Gdańsk]], then [[Danzig#History]] will link to the "History" section of the article Gdańsk. It is also possible for the target of a redirect to be defined as a specific section or anchor of a page (these work only if JavaScript is enabled). Indeed, [[MOS:SECTLINK |according to the Manual of Style]], it may be preferable to define such redirects, and use them when linking to those sections/anchors, rather than linking using the {{nowrap |<code><nowiki>[[Page name#Section or anchor name|displayed text]]</nowiki></code>}} or {{nowrap |<code><nowiki>{{Section link|Page name|Section name}}</nowiki></code>}} syntax. This way, if the section or anchored text later becomes its own article, links via the redirect won't need to be rewritten.

For example, [[Project:Section link]] redirects specifically to the section [[Help:Link#Section linking (anchors)]] on this page. A quirk of the way this works is that if one were to add a section name when using such a link, it would override the section specified by the redirect. So [[Project:Section link#Interwiki links]] would go to the "Interwiki links" section of this page. Such overriding of section redirects should be avoided.

The {{tl|Visible anchor}} template can be used to create {{visible anchor|Visible anchor example|text=an anchor associated with text that is highlighted when the anchor is linked to}} ([[#Visible anchor example|example - click here]]).  The template's first parameter will be used as both the anchor and the display text ({{para|text}} can be used to provide different display text).

===Duplicate section names===
{{Shortcut|WP:DUPSECTNAME}}
If more than one section on a destination page has the same title, a link to the title is to the first section with that title. If the link should be to another section with the title or a title that differs only in capitalization (Example vs. EXAMPLE), append to the linked title _2, _3, and so on, without a space (or 2, 3, and so on ''with'' a space), counting from the top of the destination page and without regard to whether a section is a section or a subsection. For example, multiple sections titled "History" may be linked to as "History", "History_2" (or "History 2"), and so on.

===Linking to part of a section===
{{shortcut|WP:LINKPART}}
{{see also|#Table row linking}}

Anchors can also be used to link to any part of a section. For example, if you want to link to the fifth sentence of a section, you place an anchor at the start of that sentence, and you can then link to that anchor in the same way as you would link to any other anchor. 

However, just as with section names, duplicate anchor names only link to the first one. Since anchors aren't displayed you have a much greater freedom in picking unique anchors, such as by appending the current date and time to the anchor name (for example, by naming an anchor for section "ThisSection" like so: <nowiki>{{Anchor|ThisSection2014-09-22-18-05a1}}</nowiki>&nbsp;).

Anchors can be placed anywhere, including at the start of a clause, and inside notes and citations, though it is advisable to test first in your [[Draft:Sandbox|sandbox]] before trying some exotic new kind of location for the first time. Also the anchor has to be placed after any indicators that are only recognized at the start of a line (such as == or ===, etc., for new section, * for new bullet point, : for indentation), as the anchor should still work, but the start-of-line indicator usually no longer will (and you may not always notice this, perhaps especially if you are in a hurry).

There are a small number of special anchor names. See {{slink|#Table row linking}}.

==Table row linking==
To create an anchor for a row of a table, see {{slink|Help:Tables and locations#Section_link_or_map_link_to_a_row_anchor}}. However, <code><nowiki>[[#top]]</nowiki></code> and <code><nowiki>[[#toc]]</nowiki></code> are reserved names that link to the top of a page and the table of contents, respectively.

== Piped link ==
{{See also|Help:Pipe trick}}{{Shortcut|H:PIPE}}
A '''piped link''' is an internal link or [[Help:Interwiki linking|interwiki link]] where the link target and link label are both specified. This is needed in the case that they are not equal, while also the link label is not equal to the link target with the last word extended: 
* <code>'''<nowiki>[[cheese]]</nowiki>'''</code> ''(label = target, no pipe needed)'' 
*: produces [[cheese]], linked to the article '''Cheese'''.
* <code>'''<nowiki>[[cheese]]s</nowiki>'''</code> ''(label = target + extension ["s"], no pipe needed)'' 
*: produces [[cheese]]s, linked to the article '''Cheese'''.
* <code>'''<nowiki>[[blue cheese|cheese]]</nowiki>'''</code>  ''(label = part of target, pipe required)'' 
*: produces [[blue cheese|cheese]], linked to the article '''Blue cheese'''.
* <code>'''<nowiki>[[cheese|blue cheese]]</nowiki>'''</code>  ''(label = target + additional text ["blue"], pipe required)''  
*: produces [[cheese|blue cheese]], linked to the article '''Cheese'''.
* <code>'''<nowiki>[[cheese|that stuff]]</nowiki>'''</code>  ''(label is completely different from target, pipe required)''  
*: produces [[cheese|that stuff]], linked to the article '''Cheese'''.
This allows linking a word or phrase within the text of a page rather than using "see also", even if the wording does not exactly correspond with the name of the target page. With a suitable browser and depending on the [[Help:Preferences|preferences]] set, one can still see the link target: when you point at the link, the name shows up in a hover tooltip and is also shown in the status bar.

For instance:

<code><nowiki>[[Train station|station]]</nowiki></code><br />
will show: [[train station|station]]

This is useful where the word "station" is used in an article on trains; from the context, it would be clear that a train station is meant. The piped link is more convenient to the user than a link to [[station]] which might be a disambiguation page.

The word ''piped'' refers to the use of the pipe character "|" used to separate the good description from the actual link. This character is named after another use of it; see [[Pipe (computing)]].

There are various tricks to get the same result with less typing:
* Leave the part to the right empty – the "[[#Automatic conversion of wikitext with the pipe trick|pipe trick]]" 
* Leave the part to the left empty – the "{{pslink|inverse pipe trick}}"
* Just attach text to the link, as in "<nowiki>[[train]]s</nowiki>", see [[MOS:PIPE]].

=== Using a redirect as alternative ===

An alternative to a piped link is using [[Help:Redirect|redirect pages]]. For example, to create [[How to set up a coffee house]], use <code><nowiki>[[How to set up a coffee house]]</nowiki></code> and make this a redirect to [[coffeehouse setup]]. This is convenient if the redirect is already there or will also be of use elsewhere; however, there are a few drawbacks:

* The tooltip does not show the page one will arrive at.
* "[[Help:Related changes|Related changes]]" gives the changes in the ''redirect page'', not the redirect target.

Combining a piped link and a redirect, one can provide some information that is not the name of the page one links to in the hover tooltip, e.g., the pipe to a redirect <code><nowiki>[[United Nations Organization|UNO]]</nowiki></code> will display a tooltip "United Nations Organization" when hovering over [[United Nations Organization|UNO]], thereby explaining the abbreviation. (However, {{tl|abbr}} is preferred for abbreviations.)

=== Automatic conversion of wikitext with the pipe trick ===
{{See also|Help:Pipe trick}}

If in a piped link the part after the "|" is left empty, it is [[Help:Automatic conversion of wikitext|converted]] to an abbreviated form of the linked page, as follows:

# Any word before the first colon (:), as well as the colon itself, is removed. This word may or may not be a namespace prefix (such as "Help:") or an interwiki prefix (such as "commons:"). If the page name is preceded by a colon, "first" refers to "first after this".
# If there is text in parentheses at the end it will be removed.
# If there are no parentheses but there is a comma, the comma and everything after it are removed.
# The link will be in whatever case is used.

Just like for the three or four tildes when signing on Talk pages and the use of <code>subst</code>, in a preview, the result already shows up in the preview itself, but the conversion in the edit box is not yet shown. Press "Show changes" to see the change in the wikitext.

;Category tag
:The sort key syntax of the category being like a piped link, the pipe trick also works for category tags, even though it is not useful there.
;Examples using colons
: <code><nowiki>[[Help:Template|]]</nowiki></code> is converted to <nowiki>[[Help:Template|Template]]</nowiki>, which is rendered as [[Help:Template|Template]].
: <code><nowiki>[[Music: My life|]]</nowiki></code> is converted to <nowiki>[[Music: My life| My life]]</nowiki>, which is rendered as [[Music: My life| My life]] – although "Music:" is not a namespace (therefore the space after the colon is not automatically removed), the shortcut works anyway.
: <code><nowiki>[[w:en:Pipe (computing)|]]</nowiki></code> is converted to <nowiki>[[w:en:Pipe (computing)|en:Pipe]]</nowiki>, which is rendered as [[w:en:Pipe (computing)|en:Pipe]].
;Case examples
: <code><nowiki>[[pipe (computing)|]]</nowiki></code> is converted to <nowiki>[[pipe (computing)|pipe]]</nowiki> which is rendered as [[pipe (computing)|pipe]].
: <code><nowiki>[[Pipe (computing)|]]</nowiki></code> is converted to <nowiki>[[Pipe (computing)|Pipe]]</nowiki> which is rendered as [[Pipe (computing)|Pipe]].
;Comma example
: <code><nowiki>[[commons:Boston, Massachusetts|]]</nowiki></code> is converted to <nowiki>[[commons:Boston, Massachusetts|Boston]]</nowiki>, which is rendered as [[commons:Boston, Massachusetts|Boston]].
;Other examples
:[[Help:Templates#Parameters|Parameters]] and [[Help:magic words#Variables|variables]]:
:<code><nowiki>[[w:{{{1}}}|]]</nowiki></code> does ''not'' give <nowiki>[[w:{{{1}}}|{{{1}}}]]</nowiki>.
: Calling the template with a value of parameter 1 gives a working link in the case of substitution only.
:<code><nowiki>[[w:en:{{FULLPAGENAME}}|]]</nowiki></code> does ''not'' give <nowiki>[[w:en:{{FULLPAGENAME}}|en:{{FULLPAGENAME}}]]</nowiki>.
: <code><nowiki>[[m:{{FULLPAGENAME}}|]]</nowiki></code> does ''not'' give <nowiki>[[m:{{FULLPAGENAME}}|{{FULLPAGENAME}}]]</nowiki>

<syntaxhighlight lang="wikitext">
* [[project:a (b)|]]
* [[w:project:a (b)|]]
* [[:de:project:a (b)|]]
* [[wiktionary:project:a (b)|]]
* [[wiktionary:de:project:a (b)|]]
* [[wikibooks:project:a (b)|]]
* [[wikiquote:project:a (b)|]]
* [[wikisource:project:a (b)|]]
* [[w:en:{{FULLPAGENAME}}|]]
** [[w:en:{{FULLPAGENAME}}|en:{{FULLPAGENAME}}]]
* [[m:{{FULLPAGENAME}}|]]
** [[m:{{FULLPAGENAME}}|{{FULLPAGENAME}}]]
</syntaxhighlight>

These examples appear as:

* [[project:a (b)|a]]
* [[w:project:a (b)|project:a]]
* [[:de:project:a (b)|project:a]]
* [[wiktionary:project:a (b)|project:a]]
* [[wiktionary:de:project:a (b)|de:project:a]]
* [[wikibooks:project:a (b)|project:a]]
* [[wikiquote:project:a (b)|project:a]]
* [[wikisource:project:a (b)|project:a]]
* [[w:en:{{FULLPAGENAME}}|]]
** [[w:en:{{FULLPAGENAME}}|en:{{FULLPAGENAME}}]]
* [[m:{{FULLPAGENAME}}|]]
** [[m:{{FULLPAGENAME}}|{{FULLPAGENAME}}]]

=== Inverse pipe trick ===

On page "A (c)", <code><nowiki>[[|B]]</nowiki></code> is automatically converted to <nowiki>[[B (c)|B]]</nowiki>.

Similarly, on page "A, c", <code><nowiki>[[|B]]</nowiki></code> is automatically converted to <nowiki>[[B, c|B]]</nowiki>.

[[Help:Pipe_trick#Reverse_pipe_trick|Further examples are here.]]

== Subpage links ==
A wikilink needs a <kbd>[[''fullpagename'']<nowiki />]</kbd>, and this is not optional
except when it links to or from a [[Help:subpage|subpage]].
A wikilink to its parent page is <kbd>[[../]]</kbd>,
and, although no page name is given, the [[wp:pgn|fullpagename]] is rendered.
On the parent a wikilink to a subpage can use <kbd>[[/''subpagename'']<nowiki />]</kbd> to render a subpagename instead.

Although subpages are created in article space, 
subpage linking does not fully function there.
 
Subpage linking works as expected to link to any pages under a root parent page:
* section linking: <kbd>[[../#''section'']]</kbd>
* child-to-child subpage linking: <kbd>[[../''[[wp:pgn#Subpagename_and_basepagename|subpagename]]'']<nowiki />]</kbd>
* parent's parent <kbd>[[../../]]</kbd>
* including the <kbd>[[../{{!}}[[wp:pipe trick|''pipe trick'']]</kbd>
* and including [[help:transclusion|transclusion]]s: <kbd>{{../}<nowiki />} </kbd> and <kbd>{{/''subpagename''}<nowiki />} </kbd>

Consider that there are about 140 {{search link|prefix:Project: Manual of style/|subpages of the ''Manual of style''}} arranged in 97 branches, 35 of which have two subpages, and 5 of which have three subpages. Subpage links save typing. Say you're editing this closely related group of fullpagenames:

:[[Project:Manual of Style/Accessibility/Signatures]] 
:[[Project:Manual of Style/Accessibility/Data tables tutorial]] 
:[[Project:Manual of Style/Accessibility/Data tables tutorial/Internal guidelines]]

{| class="wikitable"
|-
! On subpagename !! You type!! You get!! Links to
|-
| Data tables tutorial || <code>[[../]<nowiki />]</code> || {{font color|blue|Project:Manual of Style/Accessibility}} || Parent
|-
| Internal{{zwsp}}guidelines || <code>[[../../]]</code> || {{font color|blue|Project:Manual of Style/Accessibility}} || Grandparent
|-
| Accessibility || <code>[[/Signatures]<nowiki />]</code> || {{font color|blue|/Signatures}}|| Child
|-
| Accessibility || <code>[[/Signatures<mark>/</mark>]<nowiki/>]</code> || {{font color|blue|Signatures}}|| Child 
|-
| Data tables tutorial || <code>[[../Signatures]<nowiki />]</code> || {{font color|blue|Project:Manual of Style/Accessibility/Signatures}}|| Sibling
|-
| Data tables tutorial || <code>[[../Signatures/]<nowiki />]</code> || {{font color|blue|Signatures}}|| Sibling
|-
| Internal{{zwsp}}guidelines || style=white-space:nowrap | <code>[[../../Signatures]<nowiki />]</code> || {{font color|blue|Project:Manual of Style/Accessibility/Signatures}}|| Uncle
|-
| Signatures || style=white-space:nowrap | <code>[[../Data tables tutorial/Internal guidelines]<nowiki />]</code> || {{font color|blue|Project:Manual of Style/Accessibility/Data tables tutorial/Internal guidelines}}|| Nephew
|-
|}

To see this page's array of subpage variables and markup four levels deep, see [[/one/two/three/four]], and from there go to level two at ''one/two''.

Markup <kbd>[<nowiki />[../]]</kbd> addresses the ''basepagename'', except when a ''pagename'' includes a <kbd>/</kbd> slash character (allowed), the basepagename/subpagename variables' characters are skewed. To see all this, and how adding an extra <kbd>../</kbd> construct fixes the resulting [[wp:redlink|redlink]], see [[/sub/page/name1/sub/page/name2/subpage level 3]], and from there go to ''sub/page/name2''.

Note that the top of every subpage shows the [[breadcrumb (navigation)|navigation links]] to all ''parent'' subpagenames. From these you can easily gauge levels and linking constructs.

For more information:
* See [[Project:Page name#Subpagename and basepagename]].
* ''Create'' a subpage by using a ''[[Help:red link|red link]]''.
* See [[m:Help:Link#Subpage feature]].
* See examples at [[m:Link/a/b]] and [[m:Help:Link/a/b]].

== Special pages links ==
{{main|Help:Special page#Linking to or listing special pages}}
To create a link to a special page:

<code><nowiki>[[Special:PrefixIndex/HMS]]</nowiki></code> → [[Special:PrefixIndex/HMS]]

Because the ampersand character (&) is disallowed, it is not possible to create an ordinary link containing <code>&action=edit</code> or <code>&redirect=no</code> in the URL query string. In these cases, use templates or magic words, see [[#Links containing URL query strings]].

For example, you can use a template such as {{tl|Plain link}} to encode a Wikimedia url link, such as one pointing to a special page with parameters.
: <nowiki>{{Plain link|url=https://en.{{SITENAME}}.org/w/index.php?title=Special:Log&logid=79269392|name=15:21, 8 December 2016}}</nowiki>
gives
: {{Plain link|url=https://en.{{SITENAME}}.org/w/index.php?title=Special:Log&logid=79269392|name=15:21, 8 December 2016}} 

== Changing link appearance ==

The ways that various links are displayed in browsers, as described above, are the default display styles in the default [[WP:Skin|skin]]. Users can change the way they see links:
* By selecting a different skin.
* By applying a [[Help:User style|user style]] using CSS (see [[Help:Link color]]).
* By changing the "Underline links" value on the [[Special:Preferences#mw-prefsection-rendering|Appearance tab]] of [[Help:Preferences|user preferences]].

== Hover tooltips ==

In many browsers, holding the cursor over a link ([[mouseover]]) shows a hover [[tooltip]] containing the text of the link's [[HTML]] <code>title</code> attribute. MediaWiki – the software which runs {{SITENAME}} – sets this to the target page name (without any section indication) if it's a wikilink, the page name with prefix if it's an interwiki link, and the link address ([[URL]]) if it's an external link. (This can be switched off in the [[Help:Preferences|user preferences]].) The browser may also show similar information, including any section indication, in the status bar.

For these effects a piped link is useful even if it is not followed; for example, for displaying the meaning of an acronym. It is possible to produce a hover tooltip without a link, using the {{tl|Tooltip}} template.

== Disallowed characters ==

A link whose target contains disallowed characters (see [[WP:Page name]]) will be displayed without markup, as in <code>[[A{b}]]</code>.

Conversions are automatically made to [[Help:Special characters|non-literal characters]] in wiki and interwiki links. For example, <code><nowiki>[[Help:Page%20name]]</nowiki></code> becomes <code>[[Help:Page name]]</code>. However, the opposite is true for external links; literal characters are converted into non-literal characters. For example, most browsers convert <code>.../wiki/!</code> to <code>.../wiki/%21</code>.

Some characters in a web address link need to be represented as [[escape character]]s because they are reserved for {{SITENAME}} edits. Examples include <code>%5B</code> for <code>[</code>, <code>%5D</code> for <code>]</code>, <code>%3C</code> for <code><</code>, <code>%3E</code> for <code>></code>, <code>%7B</code> for <code>{</code>, <code>%7D</code> for <code>}</code>, <code>%7C</code> for <code>|</code>, and <code>%26</code> for <code>&</code>. More can be found by reading about [[Percent_encoding#Percent-encoding_reserved_characters|percent encoding]]. [[Numeric character reference]]s (e.g. <code>&amp;#91;</code> or <code>&amp;#x5B;</code>) should not be used in external links because the ampersand character (&) has a special meaning in a URL.

In excessive cases, an automatic [https://www.w3schools.com/tags/ref_urlencode.ASP percent encoder such as the one at W3 Schools] (use the second JavaScript form under "URL Encoding Functions") is probably the simplest solution.  For example, pasting <code><nowiki>Help talk:Citation Style 1/Archive 41#{{Cite book}} and |contribution problems</nowiki></code> into that form yields the wikilink <code><nowiki>[[Help%20talk%3ACitation%20Style%201%2FArchive%2041%23%7B%7BCite%20book%7D%7D%20and%20%7Ccontribution%20problems]]</nowiki></code>, which appears as [[Help%20talk%3ACitation%20Style%201%2FArchive%2041%23%7B%7BCite%20book%7D%7D%20and%20%7Ccontribution%20problems]], as desired.<ref>Note that this wikitext isn't as pretty as the manual method, which would yield <code><nowiki>[[Help talk:Citation Style 1/Archive 41#%7B%7BCite book%7D%7D and %7Ccontribution problems]]</nowiki></code>.  This is because the encoder converts characters like space, :, and # which are legal in wikilinks and don't need to be converted.</ref>

{{anchor|Links containing URL query strings}}
=== Links containing ampersands ===

Because the [[Ampersand|ampersand character]] (&) is disallowed, it is not possible to create an ordinary link containing <code>&action=edit</code> or <code>&redirect=no</code> in the URL query string. These kinds of links can be helpful in user pages. Also, a redirect page can have categories and you might wish to view or edit these in a single click.  There are three ways to create these links:

* You can use the {{tl|Querylink}} template to append query parameters to a {{SITENAME}} page URL. For example, <code><nowiki>{{Querylink|Help:Link|qs=action=history|this page's history}}</nowiki></code> produces the link {{Querylink|Help:Link|qs=action=history|this page's history}}.
* You can use the {{tl|Plain link}} template to encode a Wikimedia url link. For example,<code><nowiki>{{Plain link|url=https://en.{{SITENAME}}.org/w/index.php?title=Special:Log&logid=79269392|name=query}}</nowiki></code> yields the link {{plain link|url=https://en.{{SITENAME}}.org/w/index.php?title=Special:Log&logid=79269392|name=query}}.
* You can use the [[Help:Magic words|magic word]] <code>fullurl</code>. For example, to append <code>action=edit</code> to a URL query string you could use <code><nowiki>[{{fullurl:Help:Link|action=history}} this page's history]</nowiki></code>, which renders as [{{fullurl:Help:Link|action=history}} this page's history]. Note that this will render as an external link rather than as an internal link and for this reason it might not appear in what-links-here queries associated with the target page.

== Link reports ==
{{more|Help:What links here}}

The navigable links to a page are wikilinks, redirects, and external-styled wikilinks.
The {{tl|orphan}} tag can be placed on pages with no incoming wikilinks.

=== To a page ===
Each link to a page is a link to a ''name''.<ref> 
The aliases for the namespace part of the name are recognized in 
wikilinks and in the parser functions that create URL style links – canonicalurl and fullurl.
They are also recognized in the navigation box, and in Search,
except for the ''insource'' parameter.
</ref> No one report shows all links to the ''content''.

The [[Help:What links here|What links here]] tool, on every page, 
will report all wikilinks and all redirects to the ''content'' of that page.
(You get the wikilinks to the redirects too.)
The [[H:S|search]] parameter '''linksto''' will find wikilinks only.
Both report (invisible) wikilinks placed by a transclusion through a {<nowiki/>{[[help:template|template]]}}.
The difference between them is that ''linksto'' reports a count of links to ''a page name'',
while ''WhatLinksHere'' reports a map of links to ''the page as content''.<ref>
"What Links Here" does not report URL-style links to a page.</ref>

=== To a section ===
The navigable links to a section of a page are wikilinks, redirects, and URL-styled wikilinks.
The difference between a redirect and a wikilink is most pronounced where a redirect targets a section,
when you cannot add your own <kbd>#''section''</kbd>{{space}} to it
even though it appears as <code>[<nowiki/>[''page name'']]</code>.
A wikilink that links to a section ''and'' that appears as <code>[<nowiki/>[''page name''#''section name'']]</code> 
can link to that section through the canonical page name (the title on the page with the actual content) 
or through the page name of any redirect to it, in which case the page name is the name of a redirect page.

To find wikilinks to a section requires two or more reports.

# '''Show redirects only''', an external tool available from the '''What&nbsp;links&nbsp;here''' page, reports redirects to the ''content'' of a section. (No matter which page ''name'' you give it, you get all the redirect page names.) Look past any "'''''No anchor or section'''''" group of redirects, and any "invalid" sections, to see if your particular section name is explicitly listed, because then the redirect pages under it can have incoming links that will then go to that section.<ref> Redirects that link to a section are part of a valiant effort to enable changing a section heading without breaking a link to the ''name''. That effort also must ask editors who want to link to a section to always check the wikitext of the target section, and there find, read and understand the plan to link to a single redirect page instead. Then that redirect page links to the section. ("Invalid" redirects to a non-existing anchor or section occur when this is overlooked.) </ref> ("What Links Here" also has a "show redirects" report, but it doesn't specify if the redirect goes to any particular section.)
# Use "What Links Here" on any redirect pages found in the previous step. 
# Use {{tl|Links to}} to create a group of search links that will each report some links to a section. It can work with only one page name at a time. For each search link given, just change the page name in the query to each redirect in turn.

The more redirects there are, the more reports there are to run.
If there are no redirects involved, one report from "Links to" is enough.

=== From a page ===
To report links ''from'' a page, you simply list all the wikilinks on that page.
* {{slink|Project:Tools/Editing tools|Relink}} can count wikilinks from a copy of the wikitext on your local machine.
* Some [[Project:text editor support|text editors support]] the counting and highlighting of the <code>[<nowiki/>[...]]</code> pattern occurrences.
* The {{SITENAME}} [[Application programming interface#Web APIs|web API]] accepts queries by URL.<ref>
If you will use the API heavily or professionally you should follow its currently listed recommendations at [[mw:API:Query|API]].
(Use <kbd>continue=</kbd>, use <kbd>formatversion2</kbd>, use multiple pages at once, etc.)</ref>
One way to send a query to the API is by creating an external link ({{slink||External links}}).
For example, using an external link very much like a search link, you can
send the API a request to list the link properties of "[[wp:example]]".
It should interpret it correctly as "Project:Example", ''pageid 25263910''.
; What you type
:<kbd>[/<nowiki/>/en.{{SITENAME}}.org/w/api.php?action=query&prop=links&pllimit=500&titles=''fullpagename'' ''your label'']</kbd>
; What you get when fullpagename is [[wp:example]]
:[//en.{{SITENAME}}.org/w/api.php?action=query&prop=links&pllimit=500&titles=wp:example ''your label'']
* The report is in [[JSON]] format, as is usual for RESTful APIs.
* The pageid is available from '''Page information''' on every page.
* The <kbd>titles</kbd> parameter is plural. (It is designed to take multiple fullpagenames or pageid, delimited by the | pipe character.)
* The number of links returned by this query is limited to 500, per the URL you created. See [[mw:API:Query]] for how to safely get more. For example, [[Operating system]] has 510 wikilinks.

To make a page register as a link to a page, but without actually showing the link,
make a link to it, but label it with a space character using the pipe trick: <kbd>[<nowiki/>[''pagename''|&nbsp;]]</kbd>.

== Additional link-related functions ==

For the effect that links have on date formatting, see [[Help:Date formatting and linking]].

Another link-dependent feature is [[Help:Related changes|related changes]], which make it possible to view recent changes to all pages which are linked from the current page (or which are members of the category, if it is a category page).

For information on how to link to pages from an image, see [[mw:Extension:ImageMap]].

Several [[Help:Template|templates]] have been created to make linking easier (although they are not usually used in article space). These include {{tl|tl}} and {{tl|tlx}} for linking to templates, and {{tl|cl|}} and {{tl|lc}} for linking to categories. More can be found in [[:Category:Internal link templates]].

== Conversion to canonical form ==
{{See|mw:Manual:Title.php#Canonical forms}}
As [[#Wikilinks|described previously]], if a link target begins with a lower case letter, it will be interpreted as if it began with the equivalent capital letter. If the target contains a [[Help:Namespace|namespace]] prefix, then the whole prefix and the first character after the colon are case-insensitive (so [[uSeR:jimbo Wales]] links to [[User:Jimbo Wales]]).

In link targets, spaces and underscores (which are effectively equivalent) are ignored if they come at the start, at the end, or immediately before or after the colon following a namespace prefix. Consecutive spaces / underscores are treated as a single space. Hence [[_User_: Jimbo_ __ Wales__]] links to [[User:Jimbo Wales]].

[[HTML character reference]]s and [[percent encoding|percent-encoded]] characters are replaced with their raw character. For example, <code><nowiki>[[d&amp;eacute;partement]]</nowiki></code> produces [[d&eacute;partement]], and <code><nowiki>[[%40]]</nowiki></code> produces [[%40]]. Links which resolve to [[Project:Naming conventions (technical restrictions)|invalid page titles]] are displayed as unmarked-up wikitext.

Titles indicated by wikilinks are displayed in canonical form (with correction of capitalization and excess spaces / underscores removed, as described previously) in the following places:
* In [[Help:Transclusion|transclusion]] tags for non-existent pages: <code><nowiki>{{qwsazx}}</nowiki></code> gives [[Template:Qwsazx]].
* In tooltips and in the status bar (if applicable for the browser) when the mouse cursor is moved over the link.
* On [[Help:Redirect|redirect]] pages.
* In the [[WP:Category|category]] box.

The prefixes in [[Help:Interwiki linking|interwiki links]] are treated similarly to namespace prefixes: they are insensitive to case and to spaces before and after the colon. However the first character after the colon is ''not'' automatically capitalized (whether it is interpreted as a capital depends on the configuration of the target wiki).

== See also ==
* [[User:Edward/Find link|Find link tool]]: a simple tool that lets you search for articles to consider adding links to.
** [[:m:Clean linking|Clean linking]]
* [[mw:Help:Links|MediaWiki help page on links]]
* [[Help:Link color]]: the color of a [[WP:LINK|link]] shows the status of the corresponding target page.
* [[Help:Pipe trick]]: uses the [[pipe character]] ("{{code|{{!}}}}") to save typing the label of a piped link.
* [[Help:Permanent link]]: creating a permanent link to a page revision.
* [[User:V111P/js/Smart Linking|Smart Linking tool]]: a tool for linking and previewing the linked article above the text box with the wiki code.
* [[Help:Self link]]: self links is a link to the page itself. A self-link to a page appears as bold text when the article is viewed.
* [[Project:Shortcut]]: a specialized type of redirect page that provides an abbreviated wikilink to a project page.
* [[Help:Colon trick]]: a trick when providing category, image or interwiki links.
* {{sectionlink|Project:Orphan|Step 2: Finding related articles}}
* [[User:Tony1/Build your linking skills]], a tutorial on high-quality linking with practice questions

== Notes and references ==
{{reflist}}

{{Help navigation}}
{{{{SITENAME}} technical help|collapsed}}
[[Category:{{SITENAME}} link help| ]]
[[Category:{{SITENAME}} links| ]]