ok, giving up, github does not render asciidoc well at all.

Is there something we can use to generate manpages from markdown?

docs/man/man5/ansible-playbook.5.asciidoc

@@ -29,25 +29,7 @@ be supported in the future.
 EXAMPLE
 -------
 
-Remove the '# before pasting in the file, it's not part of the format and is only here to
-make github render properly
-
-[source]
-- pattern: '*'
-  hosts: '/etc/ansible/hosts'
-  tasks:
-  - name: configure template & module variables for future template calls
-    action: setup http_port=80 max_clients=200
-  - name: write the apache config file
-    action: template src=/srv/templates/httpd.j2 dest=/etc/httpd/conf
-    notify:
-    - restart apache
-  - name: ensure apache is running
-    action: service name=httpd state=started
-  handlers:
-    - name: restart apache
-    - action: service name=httpd state=restarted
-
+see https://github.com/mpdehaan/ansible/blob/master/examples/playbook.yml
 
 WHAT THE EXAMPLE MEANS
 -----------------------