Troubleshooting Common Issues in MemPad’s HTML
1. Broken formatting or missing styles
- Cause: Incorrect HTML tags or mismatched opening/closing tags in templates.
- Fix: Validate HTML structure; ensure tags are properly nested. Replace stray characters (e.g., stray ampersands or entities). Test by simplifying to a minimal template and reintroducing parts.
2. Images not showing
- Cause: Incorrect file paths or unsupported formats.
- Fix: Use absolute paths or correct relative paths; ensure image files are in the expected folder. Prefer PNG/JPEG. Check for URL-encoding issues (spaces, special chars).
3. CSS not applying
- Cause: Inline styles overridden, wrong selectors, or stylesheet not linked.
- Fix: Confirm stylesheet link is correct and loaded. Use browser inspector or a simple HTML viewer to see computed styles. Apply !important sparingly to debug selector specificity.
4. Special characters display as entities (e.g., ‘)
- Cause: Double-escaped HTML entities or incorrect encoding.
- Fix: Ensure file encoding is UTF-8 without BOM. Decode entities where needed or avoid double-escaping when saving templates.
5. Templates not updating in the app
- Cause: Caching or wrong template file being edited.
- Fix: Restart MemPad or clear app cache. Verify you’re editing the active template file (check timestamps and file paths).
6. Links not working
- Cause: Malformed href values or missing protocol for external links.
- Fix: Use full URLs (https://…) for external links; ensure internal anchors have matching ids.
7. Unexpected behavior with scripts
- Cause: Scripts blocked by the app or sandboxing, or syntax errors.
- Fix: Avoid relying on external JavaScript; if used, test for errors with a console-capable HTML viewer. Keep scripts minimal and inline where supported.
8. Fonts rendering poorly
- Cause: Missing font files or unsupported web fonts.
- Fix: Use system fonts or include local font files. Confirm font-family fallbacks.
9. Performance issues with large templates
- Cause: Heavy images, large embedded data, or complex DOM.
- Fix: Optimize images, simplify HTML structure, and paginate or split large content.
10. Debugging checklist (quick)
- Validate HTML (online validator).
- Check file encoding (UTF-8).
- Verify correct file path and that you’re editing the active template.
- Test changes in a simple HTML viewer/browser.
- Restart MemPad after changes.
If you want, I can provide a minimal working MemPad HTML template tailored to your needs (notes layout, images, links).
Leave a Reply