Troubleshooting

Troubleshooting

HTML Rendering Issues

Unexpected behavior can occur in rendered pages due to a number of different reasons. One of these reasons is when the rendered pages are not valid HTML.

Incorrect HTML markup can be due to:

  • nesting block-level elements inside <p> or <span> elements
  • missing <tbody> tags
Example: block-level elements inside <span> elements

<span id="example">

Animal | Trainable? | Price | Remarks
:------|:----------:|------:|--------
Ants   |     no     |     5 |
Bees   |     no     |    20 |
Cats   |    yes     |   100 |
</span>

The table specified by the markdown syntax above will be rendered as a block-level element, which will be included in a inline span element. This makes the HTML output invalid.

Underlying Error (Example)

A possible fix for the above situation is to wrap the table in a <div> element instead:


<div id="example">

Animal | Trainable? | Price | Remarks
:------|:----------:|------:|--------
Ants   |     no     |     5 |
Bees   |     no     |    20 |
Cats   |    yes     |   100 |
</div>