The table at the top of http://matplotlib.org/devdocs/api/markers_api.html could be improved.

• The curly quotes are sometimes in the wrong direction (probably just wrap everything in backquotes).
• What's the difference between "triangle_down" and "tri_down", if any? It may be better to actually just draw the markers in the table (possibly using some resembling unicode characters, to keep things simpler?).
• How do I specify TICKLEFT, CARETLEFT and friends? (and again I have no ideas how these markers look like)
• The various "nothing" entries could be merged together.
• What does "the size is normalized" mean for verts? Single x/y rescaling so that the max size (between x and y) is equal to whatever?
• The (numsides, style, angle) entry could easily fit within the table itself (not sure how easy this is to do with rst though.