18 PRACTICAL GUIDES
Find out why a document is blank, unstyled, incomplete, or difficult to navigate. Diagnose the dependency before changing reader settings.
A missing image and a blank JavaScript application can look like the same failure on a phone, but they need different fixes. Use the symptom-specific guides below to separate file paths, styles, scripts, network resources, and layout issues. Work on a copy, change one variable, and check the result with the same settings your readers will use.
HTML troubleshooting · 2 min
Distinguish an empty application shell from a readable HTML document and recover useful content without indiscriminately enabling scripts.
Read guide : Diagnose a blank HTML page when JavaScript is offHTML troubleshooting · 2 min
Trace missing stylesheet dependencies, path assumptions, and export omissions before deciding whether an unstyled document needs a new artifact.
Read guide : Find why an HTML document opens without its stylingHTML troubleshooting · 2 min
Resolve image references against the document location and distinguish a correct repository path from an asset the reader can actually retrieve.
Read guide : Troubleshoot broken relative image paths in repository HTMLHTML troubleshooting · 2 min
Recognize when an image reference points to a repository browsing page and replace it with an appropriate, authorized resource or embedded asset.
Read guide : Distinguish a GitHub file page from an image resource URLHTML troubleshooting · 2 min
Isolate the widest content block, repair its layout rules, and keep code or tables locally scrollable without hiding useful information.
Read guide : Find the element making an HTML document scroll sidewaysHTML troubleshooting · 2 min
Identify encoding mismatches at the source, declare UTF-8 correctly, and avoid repeatedly re-saving already damaged text.
Read guide : Repair garbled punctuation and characters in an HTML exportHTML troubleshooting · 2 min
Check fragment spelling, unique IDs, generated heading changes, and obscured targets when an HTML table of contents behaves incorrectly.
Read guide : Fix section links that do not reach the right headingHTML troubleshooting · 2 min
Inspect a base URL before debugging many broken links, images, or styles in an exported HTML document that has moved contexts.
Read guide : Find hidden URL assumptions introduced by an HTML base elementHTML troubleshooting · 2 min
Trace font dependencies, restore reliable fallback typography, and replace icon-font-only meaning in a portable HTML reading artifact.
Read guide : Recover readable text when a web font failsHTML troubleshooting · 2 min
Trace mismatched foreground and background colors across callouts, tables, and code blocks instead of applying a blanket inversion filter.
Read guide : Fix invisible text in a dark HTML documentHTML troubleshooting · 2 min
Separate file permissions from HTML path errors and choose a safe packaging approach without putting access credentials into the document.
Read guide : Diagnose missing images from a private repositoryHTML troubleshooting · 2 min
Handle unavailable iframe content by publishing a clear static summary, dated values, and source context rather than a blank embedded panel.
Read guide : Replace missing embedded dashboards with a readable snapshotHTML troubleshooting · 2 min
Turn a runtime-only chart into a static explanation with visible values, a dated visual, and a useful fallback for portable HTML reading.
Read guide : Recover a chart that disappears when scripts are disabledHTML troubleshooting · 2 min
Find dependencies supplied by your development environment and inspect the actual exported artifact in a clean reading context.
Read guide : Why an HTML file works locally but fails after sharingHTML troubleshooting · 2 min
Escape source examples correctly so tags remain visible as selectable code instead of becoming accidental elements in the reading document.
Read guide : Stop HTML examples from being interpreted as page markupHTML troubleshooting · 2 min
Inspect the SVG viewBox, fixed dimensions, labels, and surrounding layout before scaling or cropping an important technical diagram.
Read guide : Fix an SVG diagram that is clipped or tiny on a phoneHTML troubleshooting · 2 min
Diagnose video dependencies while preserving the tutorial through a transcript, timestamps, and still images that do not require playback.
Read guide : Keep a tutorial useful when its embedded video will not playHTML troubleshooting · 2 min
Recognize partial markup exported from a component and add the document metadata, context, and styling needed for independent reading.
Read guide : Turn an HTML fragment into a complete reading artifact