diff --git a/plone/app/discussion/design.txt b/plone/app/discussion/design.txt
index b2a6577..6f350eb 100644
--- a/plone/app/discussion/design.txt
+++ b/plone/app/discussion/design.txt
@@ -52,6 +52,8 @@ The inheritance tree for DiscussionItem is shown below. Classes we want to
 mix in and interface we want to implement in the Comment class are marked
 with [x].
 
+::
+
     [ ] DiscussionItem
         [ ] Document
             [ ] PortalContent                       = [ ] IContentish
@@ -79,9 +81,9 @@ with [x].
 Thus, we want:
 
   * Traversable, to get absolute_url() and friends
-        - this requires a good acquisition chain at all times
+      - this requires a good acquisition chain at all times
   * Acquisition.Explicit, to support acquisition
-        - we do not want implicit acquisition
+      - we do not want implicit acquisition
   * Owned, to be able to track ownership
   * RoleManager, to support permissions and local roles
   
@@ -126,6 +128,8 @@ could manage the 'Bypass moderation' permission.
 
 These could work in a workflow like this:
 
+::
+
   * --> [posted] -- {publish} --> [published]--> *
            |                          ^
            |                          |