Help:Basic MediaWiki Syntax: Difference between revisions
→Images: Note way to stop fill |
Syntax for additional anchors (link targets) |
||
| (11 intermediate revisions by the same user not shown) | |||
| Line 37: | Line 37: | ||
|- | |- | ||
|Internal link<br /> | |Internal link<br /> | ||
(within the Computer History wiki) | (within the Computer History wiki)<br /> | ||
''This, and the one above, can be combined.'' | |||
| | | | ||
<tt><nowiki>[[name of page]]</nowiki></tt><br /> | <tt><nowiki>[[name of page]]</nowiki></tt><br /> | ||
<tt><nowiki>[[name of page|display text]]</nowiki></tt><br /> | <tt><nowiki>[[name of page|display text]]</nowiki></tt><br /> | ||
<tt><nowiki>[[name of page#heading]]</nowiki></tt><br /> | |||
| | | | ||
[[name of page]]<br /> | [[name of page]]<br /> | ||
[[name of page|display text]]<br /> | [[name of page|display text]]<br /> | ||
[[name of page#heading]]<br /> | |||
|- | |- | ||
|colspan=" | |colspan="2"|<span style="font-size:0.9em>''Wikipedia style, followed here, is generally to only link the '''first''' instance of a term on a page.''<br /> | ||
''See below for the syntax for adding additional anchors (link targets).''</span> | |||
|- | |- | ||
|colspan="3" style="border-top:1px solid #cee0f2;"| | |colspan="3" style="border-top:1px solid #cee0f2;"| | ||
|- | |- | ||
|External link<br /> | |External link<br /> | ||
(to other websites) | (to other websites)<br /> | ||
''The middle one is '''much''' preferred.'' | |||
| | | | ||
<tt><nowiki>[http://www.example.org]</nowiki></tt><br /> | <tt><nowiki>[http://www.example.org]</nowiki></tt><br /> | ||
| Line 61: | Line 66: | ||
|- | |- | ||
|colspan="3" style="border-top:1px solid #cee0f2;"| | |colspan="3" style="border-top:1px solid #cee0f2;"| | ||
|- | |||
| | |||
Text can be commented out | |||
| | |||
matching <nowiki><!--</nowiki> and <nowiki>--></nowiki> around text to be ignored | |||
|- | |- | ||
| | | | ||
| Line 75: | Line 85: | ||
|Headings<br /> | |Headings<br /> | ||
<span style="font-size:0.9em;">''A Table of Contents will automatically be generated when four headings are added to an article.''</span> | <span style="font-size:0.9em;">''A Table of Contents will automatically be generated when four headings are added to an article.''</span> | ||
<span style="font-size:0.9em;">''For a reason that has been lost in the mists of time, Wikipedia (and thus here) uses '==' as the top level section marker; '=' seems to work now, but please keep up the style.''</span> | |||
| | | | ||
<tt><nowiki>== Level 1 ==</nowiki></tt><br /> | <tt><nowiki>== Level 1 ==</nowiki></tt><br /> | ||
| Line 83: | Line 95: | ||
| | | | ||
__TOC__ | __TOC__ | ||
== Level 1 == | == Level 1 == | ||
=== Level 2 === | === Level 2 === | ||
| Line 92: | Line 105: | ||
|- | |- | ||
|Indented items<br /> | |Indented items<br /> | ||
(used mostly on Talk: pages) | ''(used mostly on Talk: pages)'' | ||
| | | | ||
<tt>: foo</tt><br /> | <tt>: foo</tt><br /> | ||
| Line 99: | Line 112: | ||
: foo | : foo | ||
:: bar | :: bar | ||
|- | |||
|colspan="3" style="border-top:1px solid #cee0f2;"| | |||
|- | |- | ||
|Bullet list | |Bullet list | ||
| Line 127: | Line 142: | ||
|} | |} | ||
</div> | </div> | ||
To add additional anchors (link targets) at arbitrary locations inside an article, use the following syntax: | |||
''<nowiki><span id="Anchor">Optional text</span></nowiki>'' | |||
These anchors can be used in both internal and external links. | |||
==Pre-formatted text== | ==Pre-formatted text== | ||
| Line 149: | Line 170: | ||
<pre> | <pre> | ||
{| class="wikitable" | {| class="wikitable" style="text-align: center;" | ||
! Table !! Prototype | ! Table !! Prototype | ||
|- | |- | ||
| colspan="2 | | colspan="2" | Headers | ||
|- | |- | ||
| aa || rowspan="2" | yy | | aa || rowspan="2" | yy | ||
| Line 164: | Line 185: | ||
produces: | produces: | ||
{| class="wikitable" | {| class="wikitable" style="text-align:center;" | ||
! Table !! Prototype | ! Table !! Prototype | ||
|- | |- | ||
| colspan="2 | | colspan="2" | Headers | ||
|- | |- | ||
| aa || rowspan="2" | yy | | aa || rowspan="2" | yy | ||
| Line 178: | Line 199: | ||
==Images== | ==Images== | ||
<nowiki>[[ | Including the special form: | ||
<nowiki>[[File:Pdp1115.jpg|thumb|150px|left|Caption text]]</nowiki> | |||
produces: | produces: | ||
[[ | [[File:Pdp1115.jpg|thumb|150px|left|Caption text]] | ||
Leaving out the | (The legacy keyword 'Image' may be used in place of "File".) Leaving out the "150px" inserts the image full-size. The optional keywords 'left' and 'right' can be added to control the horizontal placement. | ||
(Notice that this text fills up around the image. Add a <nowiki><br clear=all></nowiki> to force the text to re-start below the image.) | (Notice that this text fills up around the image. Add a <nowiki><br clear=all></nowiki> after the image line to force the text to re-start below the image.) | ||
New images can be uploaded via the 'Upload file' page (link on the left-hand side of all pages). | New images can be uploaded via the 'Upload file' page (link on the left-hand side of all pages). | ||
A lengthy tutorial on images is [https://en.wikipedia.org/wiki/Help:Pictures here]; complete specifications for the use of the 'File' special form are available [https://en.wikipedia.org/wiki/Wikipedia:Extended_image_syntax here] and [https://www.mediawiki.org/wiki/Help:Images here]. | |||
<br clear=all> | |||
==See also== | |||
* [https://www.mediawiki.org/wiki/Help:Contents MediaWiki.org help pages] - a wealth of detail | |||
** [https://www.mediawiki.org/wiki/Help:Formatting Help:Formatting] - detailed help on formatting | |||
** [https://www.mediawiki.org/wiki/Help:Tables Help:Tables] - ditto for tables | |||
[[Category: Help]] | [[Category: Help]] | ||
Latest revision as of 15:30, 24 July 2025
This is a brief introduction to MediaWiki source syntax. For a more comprehensive guide, see here.
Text
| Description | You type | You get |
| Applies anywhere | ||
| Italicise text |
''italic'' |
italic |
| Bold text |
'''bold''' |
bold |
| Bold and italic |
'''''bold & italic''''' |
bold & italic |
| Internal link (within the Computer History wiki) |
[[name of page]] |
|
| Wikipedia style, followed here, is generally to only link the first instance of a term on a page. See below for the syntax for adding additional anchors (link targets). | ||
| External link (to other websites) |
[http://www.example.org] |
|
|
Text can be commented out |
matching <!-- and --> around text to be ignored | |
|
Sign your posts |
~~~~ |
Your username 15:26, |
| Items below only apply at the beginning of a line | ||
| Headings A Table of Contents will automatically be generated when four headings are added to an article. For a reason that has been lost in the mists of time, Wikipedia (and thus here) uses '==' as the top level section marker; '=' seems to work now, but please keep up the style. |
== Level 1 == |
Level 1Level 2Level 3Level 4Level 5 |
| Indented items (used mostly on Talk: pages) |
: foo |
|
| Bullet list |
* one |
|
| Numbered list |
# one |
|
To add additional anchors (link targets) at arbitrary locations inside an article, use the following syntax:
<span id="Anchor">Optional text</span>
These anchors can be used in both internal and external links.
Pre-formatted text
There are a number of ways to include pre-formatted text (e.g. source code fragments); all of these techniques also use a fixed-width font for the text:
- Start each line with a space character; normal markups can be used; e.g.:
" This is '''pre-formatted''' text"
produces:
This is pre-formatted text
- Use the HTML <nowiki> tag, with a space character before the <nowiki>. (Remember to add a matching closing tag after the pre-formatted text block).
- Use the HTML <pre> tag (again, remember the closing tag).
Note that the HTML <blockquote> tag only indents the block; text within it will still be justified.
Tables
{| class="wikitable" style="text-align: center;"
! Table !! Prototype
|-
| colspan="2" | Headers
|-
| aa || rowspan="2" | yy
|-
| bb
|-
| cc || zz
|}
produces:
| Table | Prototype |
|---|---|
| Headers | |
| aa | yy |
| bb | |
| cc | zz |
Images
Including the special form:
[[File:Pdp1115.jpg|thumb|150px|left|Caption text]]
produces:

(The legacy keyword 'Image' may be used in place of "File".) Leaving out the "150px" inserts the image full-size. The optional keywords 'left' and 'right' can be added to control the horizontal placement.
(Notice that this text fills up around the image. Add a <br clear=all> after the image line to force the text to re-start below the image.)
New images can be uploaded via the 'Upload file' page (link on the left-hand side of all pages).
A lengthy tutorial on images is here; complete specifications for the use of the 'File' special form are available here and here.
See also
- MediaWiki.org help pages - a wealth of detail
- Help:Formatting - detailed help on formatting
- Help:Tables - ditto for tables