h1 heading in AsciiDoc documents on GitHub
GitHub runs AsciiDoc documents it displays on the site (e.g., README.asciidoc) through the AsciiDoc processor with the header_footer attribute disabled. As a result, the h1 heading gets dropped from the rendered output.
You can retain the h1 heading by adding a [float] directive above the title, on the first line of the document.
Here's an example:
[float]
= Document title
Now the rendered output will include the h1 heading.
Written by Dan Allen
Related protips
Have a fresh tip? Share with Coderwall community!
Post
Post a tip
Best
#Asciidoc
Authors
mojavelinux
5.855K
lordofthejars
3.507K
Sponsored by #native_company# — Learn More
#native_title#
#native_desc#