version=pmwiki-2.2.0-beta68 ordered=1 urlencoded=1 agent=Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1) author=pera charset=ISO-8859-1 csum= ctime=1141772015 host=93.86.46.197 name=PmWiki.EditGettingStarted rev=28 targets=PmWiki.MarkupMasterIndex,PmWiki.PmWiki,PmWiki.CharacterMarkup,PmWiki.LineMarkup,PmWiki.DocumentationIndex,Main.HomePage,PmWiki.Links,PmWiki.BlockMarkup,PmWiki.WikiSandbox,PmWiki.Tables,PmWiki.Images,PmWiki.WikiStyles,PmWiki.ListStyles,PmWiki.PageLists,PmWiki.PageDirectives text=(:title Introduction to Markup (editing for beginners):)%0a(:Summary:Introduction to markup (editing for beginners):)%0a[[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 [[MarkupMasterIndex | Markup master list]] page shows all available markup.%0a%0a!!Character markup%0a%0aCharacter 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.%0a%0a|| width=auto%0a||!markup ||   →   ||!result ||%0a||[=''italic text''=] || → ||''italic text'' ||%0a||[='''bold text'''=] || → ||'''bold text''' ||%0a||[='''''bold italic text'''''=] || → ||'''''bold italic text''''' ||%0a||[=[+big+] or [++bigger++]=] || → ||[+big+] or [++bigger++] ||%0a||[=[-small-] or [--smaller--]=] || → ||[-small-] or [--smaller--] ||%0a%0aOther character markup includes fixed-width typewriter font, superscript, subscript, underline, and strikeout. For more information and examples, see [[Character Markup]].%0a%0a!!Line markup%0a%0aAuthors 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.%0a%0aIf 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.%0a%0aTo make a ''heading'', start the line with exclamation marks ("!").%0a%0a(:markup class="horiz":)%0a!! A major heading%0a!!! A minor heading%0a(:markupend:)%0a%0aTo create a bulleted list, start each new line with an * markup character.%0a%0a(:markup class="horiz":)%0a* Fat Freddy's Drop%0a* Phoenix Foundation%0a* Trinity Roots%0a(:markupend:)%0a%0aTo create a numbered list, start each new line with a # markup character.%0a%0a(:markup class="horiz":)%0a# Kauri%0a# Totara%0a# Rimu%0a(:markupend:)%0a%0aTo indent text without a list symbol, start the line with -> markup.%0a%0a(:markup class="horiz":)%0a->The World's Fastest Indian%0a(:markupend:)%0a%0aFor more information, see [[Line Markup]].%0a%0a!!Links%0a%0aThe [=[[ ... ]]=] 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.%0a%0a!!!Pages in the same group%0a%0aTo 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]].%0a%0a!!!Pages in other groups%0a%0aTo 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 [[Main/Home Page]], write [=[[Main/Home Page]]=].%0a%0a!!!Pages on other sites%0a%0aTo link to a page on another site, such as [[http://example.com]], write [=[[http://example.com]]=]. Or just write http://example.com -- that works too.%0a%0a!!!Link text%0a%0aTo link to an [[http://example.com | 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 [[Main.HomePage | Introduction]].%0a%0a!!!More links%0a%0aFor more information, see [[links]].%0a%0a!!Block markup%0a%0aSome markup affects the display of several lines of text -- or text blocks. See [[block markup]]. %0a%0a!!Getting going%0a%0aAuthors can test these and other examples in the [[(Wiki )sandbox]]. Then explore [[tables]], [[images]], [[(Wiki )styles]], [[list styles]], [[page lists]], and [[(page) directives]]. time=1222148551 title=Introduction to Markup (editing for beginners)