orientation for those first being exposed to the format.

Style Formatting

Making and Preventing Links

Expressing Links

Preventing Links (and Other Processing)

Sectional Structure

Lists

Quick Reference

ZWiki's "structuredtext" format text is based on Zope's StructuredText, plus some WikiWikiWeb conventions. Both are concerned with the readability and intuitive obviousness of the raw text - to prevent formatting from getting in the way of editing. The ultimate aim is to support crafting of text that is readable and attractive in both the formatted and the raw form.

With ZWiki pages, you indicate everything, including the structure of a document - its sections and the nesting of subsections, its formatting, links, and stuff like that - using plain-text formatting conventions. (ZWiki text can include raw HTML, in case there's some elaborate HTML formatting you must do beyond what StructuredText text offers. The less HTML you use, the easier the job will be for editors - yourself included!)

The source of existing pages can provide good examples of the conventions - the text of this page, in particular, presents many central examples. Click the "Edit" or "View" in the page footer to see.

One formatting feature worth immediate attention is the way indentation level is used to distinguish sections and subsections:

This use of whitespace makes the sectional structure as obvious in the raw text as it is in the formatted result, without cluttering the raw text with peculiar, distracting marks. See Sectional Structure for more details.

Style Formatting

Making and Preventing Links

Expressing Links

Preventing Links (and Other Processing)

Sectional Structure

See this page's source for examples, and see the bit about indentation levels, above for more details.

Lists

Background and Elaboration