@laurentlb, is this possibly related to ea4840042b0c087685ab4faffab58ba6906b06f5? Testing locally, the docs render correctly. Actually, no, they just break differently. Still investigating. There are two issues, I think.

- The HTML is broken. I'm fixing it. With the fix, page should render correctly when testing locally.
- Syntax highlighting is broken on the site since my update. I suspect we need to update Jekyll or Rouge (cc @philwo). Now that 4616fdd0e2f567ae2395803e4404054a79787b22 is in, should I close this, or keep it open and re-assign for the syntax highlighting part? Asking @laurentlb whether to keep this open or not. Note that all multi-line code blocks are also broken currently, on the website itself:
https://docs.bazel.build/versions/master/skylark/aspects.html Documentation using multi-line code blocks are severely broken (https://docs.bazel.build/versions/master/android-instrumentation-test.html), I will submit a rollback to use redcarpet first.  The rollback (rollforward?) worked. Closing this for now.
Broken formatting for packaging rules
See [packaging rules docs](https://docs.bazel.build/versions/master/be/pkg.html#pkg_tar).

Formatting is very broken, tables render correctly but headers do not, italics start and stop at various places.
![packaging_rules_formatting](https://user-images.githubusercontent.com/326527/48152495-14fc9400-e292-11e8-8994-1637a0ceb793.png)

tools/build_defs/pkg/README.md
tools/build_defs/pkg/README.md
diff --git a/tools/build_defs/pkg/README.md b/tools/build_defs/pkg/README.md
index b1b962fc42136b..445e38602f82c5 100644
--- a/tools/build_defs/pkg/README.md
+++ b/tools/build_defs/pkg/README.md
@@ -118,7 +118,7 @@ Creates a tar file from a list of inputs.
         <code>String, default to 'tar'</code>
         <p>
             The extension for the resulting tarball. The output
-            file will be '<i>name<i>.<i>extension<i>'. This extension
+            file will be '<i>name</i>.<i>extension</i>'. This extension
             also decide on the compression: if set to <code>tar.gz</code>
             or <code>tgz</code> then gzip compression will be used and
             if set to <code>tar.bz2</code> or <code>tar.bzip2</code> then
@@ -284,7 +284,6 @@ Creates a tar file from a list of inputs.
       </td>
     </tr>
   </tbody>
-  </tbody>
 </table>
 
 <a name="pkg_deb"></a>
@@ -448,7 +447,6 @@ for more details on this.
       </td>
     </tr>
   </tbody>
-  </tbody>
 </table>
 
 <a name="pkg_rpm"></a>
@@ -517,5 +515,4 @@ for more details on this.
       </td>
     </tr>
   </tbody>
-  </tbody>
 </table>
