Introduction to Markup (editing for beginners)
PmWiki gives authors many ways to change how what they write gets laid out on the page. To do this, authors add markup -- text with a special meaning -- to the page's content. This page introduces some of the more commonly-used markup and points to a number of more advanced options. The Markup master list page shows all available markup.
Character markup consists of opening and closing marks around the selected text. These are combinations of characters that don't usually appear in ordinary prose. When the wiki encounters them, it changes the way the enclosed text is displayed.
Other character markup includes fixed-width typewriter font, superscript, subscript, underline, and strikeout. For more information and examples, see Character Markup.
Authors can use a variety of start-of-line markup to define paragraphs, lists, and other structures. Line markup characters include a space (" "), exclamation point ("!"), asterisk ("*"), and pound-sign ("#"). When placed at the start of a paragraph, these characters act to give the wiki formatting instructions. When used anywhere but at the start of a paragraph, it's just that character, but when used as the very first character in a paragraph, it assumes special significance to the wiki.
If there is no start-of-line markup, the text is a plain paragraph. To break text into separate paragraphs, place a blank line between the paragraphs.
To make a heading, start the line with exclamation marks ("!").
To create a bulleted list, start each new line with an * markup character.
To create a numbered list, start each new line with a # markup character.
To indent text without a list symbol, start the line with -> markup.
For more information, see Line Markup.
The [[ ... ]] markup turns text into a link. By making links to other pages or other web sites, authors makes it easier for people to find their way around. PmWiki organises pages into groups -- the full name of this page is PmWiki.EditGettingStarted; PmWiki is the group and EditGettingStarted is the name. To link to another page, an author needs to know its name.
Pages in the same group
To link to a page in the same group as the current page, such as Documentation Index, write [[Documentation Index]]. Many authors like to use capital letters for page names, but these are not essential; [[documentation index]] works just fine: documentation index.
Pages in other groups
To link to a page in another group, such as the Main.Home Page, write [[Main.Home Page]]. To link to a page in another group without showing the name of the group, such as the Home Page, write [[Main/Home Page]].
Pages on other sites
To link to an example instead of to http://example.com, write [[http://example.com | example]]. The [[link name | link text]] markup works for all types of link; thus [[Main.HomePage | Introduction]] produces Introduction.
For more information, see links.
Some markup affects the display of several lines of text -- or text blocks. See block markup.