Current well understood problems that have been mentioned more than once (in one form or another) on the ZwikiProblems pages include: (see also TextFormattingSurprises)

• StructuredText interprets single words followed by a period at the start of a paragraph as list bullets. Workaround: prepend <!---->
  fixed in 0.9.3
• StructuredText renders a final single-line paragraph as a heading if it is followed by one or more blank lines. Workaround: remove trailing blank lines or split paragraph into multiple lines.
  fixed in 0.9.3
• a StructuredText heading on the first line will not be rendered as such. Workaround: prepend a blank line.
  fixed in 0.9.3
• [THIS]? (a single word in square brackets) is incorrectly linked because StructuredText's footnote rendering conflicts with zwiki's wiki-linking
  fixed in 0.9.1
• StructuredText does not format :: examples properly if there is whitespace after the ::
  fixed in 0.9.3
• if you use a space between -- and your name when signing a paragraph, StructuredText will interpret it as a definition list element. Workaround: don't do that
• a page's title may appear blank in the header when a parent is renamed or deleted. Workaround: reset the parents property by visiting "PAGEURL/reparent".
  fixed in 0.9.1
• A page with an ID that isn't a valid WikiName can't be used for RemoteWikiLinks because something about the square brackets breaks it. There's no patch for that, but if you apply RonDagostino's code for relaxed WikiNames the problem is a lot easier to deal with.
  fixed in 0.9.1
• if the zwiki product complains with "ImportError?: cannot import name getSecurityManager", you probably need a newer zope or older zwiki. Zwiki >= 0.7 requires zope >= 2.2.
• As we found out after quite some time, the following was not a zwiki problem, maybe mentioning it here will spare some people the time we needed to realize this. Problem was that we couldn't change UserOptions? for a particular user. Entering data and pressing Set Cookies didn't set the cookies. Problem was with Netscape's (4.72) Preferrences->Advanced->Cache options, where compare time was set to "Never"! Set it to "Once per session" or "Every time" and setting UserOptions? will be fine. --BeWo
• some browsers - eg links, konqueror - don't show the latest data in form fields. Eg when you visit the edit form you may need to refresh before editing. In konqueror I have had to disable caching to get around this. (In Links, update the form fields by reloading, going back to the previous page, then going forward again to the page with the form).
• "Error Type: KeyError Error Value: seealso" when creating a zwikidotorg-style wiki**
  Fixed in recent releases of the sample wikis (certainly those shipped with zwiki 0.9.5). If you don't want to upgrade just remove the reference to seealso at /Control_Panel/Products/ZWikiWebs?/zwikidotorg/standard_wiki_footer/manage_main and try again.
• StructuredText's hyperlinks don't allow some legal urls:

  eg "test":search?expr=- .

  Use one of the other linking mechanisms.

• Konqueror seems broken as a Zope tool. Specifically when editing standard_zwiki_footer the textarea in the ZMI appears blank. When one views the source the HTML is there all right - with the proper use of & lt ; etc to have it appear as code in the editor - but it never appears. :-( This always happens if the text rendered into a textarea contains HTML comments. The bug is present from KDE 2.0 until and including KDE 2.2.2. Updating to KDE 3.0 might help (I dunno, I switched to Mozilla 1.0).

This should be merged back with TextFormattingSurprises.

and perhaps KnownIssues