Editing PmWiki (section)

=== Markup ===
The PmWiki markup shares similarities with [[MediaWiki]]. Here is a sample of commonly used markup rules.<ref> {{cite web|url=https://www.pmwiki.org/wiki/PmWiki/BasicEditing|title=PmWiki Basic Editing|access-date=2023-08-16}}</ref>

'''Links''' are usually wrapped in double brackets, optionally with link text:
<pre>
[[Other page]], [[Page|link text]], [[Page|+]] (shows the page title), 
[[Page#anchor|Link text]], [[Link#~text to be highlighted|Link to text fragment]]
https://example.com/path/, mailto:mailbox@example.com (plain links)
[[https://example.com/path/|Link text]]
Wikipedia:Wiki_software (InterMap links)
</pre>
It is possible to enable internal links for [[CamelCase]] words without brackets, and add-ons can enable other link markups like <code>@Page</code>.

'''Headings''' are preceded with exclamation marks:
<pre>
! Top-level heading (&lt;h1&gt;)
!! Second-level heading
...
!!!!!! Sixth-level heading
</pre>

It is possible to enable an automated table of contents coming with the PmWiki core, or install one among several Table of contents add-ons.<ref name=toc>{{cite web|url=https://www.pmwiki.org/wiki/PmWiki/TableOfContents|title=PmWiki / Table of contents}}</ref>

'''Lists''' are prefixed by "*" (bulleted), "#" (numbered), and ":" (description) and can be nested:
<pre>
* List item
* List item
** Nested item

# Ordered list
# Another item
** Nested bulleted item

:Term: Description
:Another term: Its description
::Nested term: Description
</pre>

'''Directives''' for listing pages and attachments, and including pages and templates:
<pre>
(:pagelist group=Cookbook order=-time count=20:)

(:attachlist name=*.jpg:)

(:include AnotherPage#fromanchor#toanchor:)

(:include MyTemplate variable=value othervariable="Some value":)
</pre>

Other page directives allow setting the page title, description, and keywords, disabling layout sections like sidebars or footers, creating tables, or defining page text variables. Add-ons allow for extra functionality.

'''Inline markup''':
<pre>
'''Bold''', ''italic'', @@code (fixed-width)@@, %classname%CSS styled text%%,
[-small text-], [+large text+], {+inserted+}, {-deleted-}, 
'^superscript^', '_subscript_',
%hlt php%[@
code block, possibly with syntax highlighting
@]
</pre>

'''[https://www.pmwiki.org/wiki/PmWiki/BlockMarkup Semantic block tags]''':
<pre>
>>classname id=identifier<<
Division block
>><<

(:div class=name id=identifier:)...(:divend:)
(:article ...:)...(:articleend:)
(:section ...:)...(:sectionend:)
(:header ...:)...(:headerend:)
(:footer ...:)...(:footerend:)
(:details summary="Toggle details":)...(:detailsend:)

(:div3 ...:)...(:div3end:) - Nested block, div, section, header, footer, article, aside, address, nav, details
</pre>


'''[https://www.pmwiki.org/wiki/PmWiki/ConditionalMarkup Conditional markup]''':
<pre>
(:if name *.HomePage:)
This is the homepage of a namespace
(:elseif auth edit:)
Current user can edit
(:else:)
...
(:ifend:)
</pre>

Other markup rules can be enabled through recipes (add-ons).

HTML is not available for the edit form out of the box, but it is possible to enable selected tags through add-ons.