Troubleshooting

Common issues and solutions for ezDoc.

Markdown Line Breaks

Problem: Pressing Enter Doesn't Create Line Breaks

Symptoms:

• Pressing Enter once doesn't create a visible line break
• Multiple blank lines collapse into one paragraph gap
• Preview doesn't show the spacing you expect

This is normal Markdown behavior! Markdown is designed this way - it's not a bug.

How Markdown Line Breaks Work:

Examples:

Line one ends with two spaces  
Line two (same paragraph, new line)

New paragraph (blank line above)

<br>
Extra space using BR tag

Why It Works This Way:

• Markdown is a source format that converts to HTML
• The Preview button shows the actual HTML output
• Your exported website will look exactly like the preview
• Preview = Export - what you see is what you get
• This behavior is consistent across all Markdown tools (GitHub, VS Code, etc.)

For Precise Spacing Control:

• Use HTML mode instead of Markdown
• Use <br> tags for line breaks
• Use Bulma spacing classes (e.g., mb-6 for margin)

💡 Tip: The preview is your friend! Always check it before exporting to ensure your formatting looks right.

Problem: Files Not Saving

Solutions:

1. Check folder permissions
2. Ensure disk space available
3. Try manual save (Ctrl+S)

Problem: Dark Mode Not Working

Solutions:

1. Check theme setting in project settings
2. Verify browser supports dark mode
3. Check OS theme settings (for System theme)
4. Clear browser cache

Export Issues

Problem: Export Fails

Solutions:

1. Check Folder Permissions

   • Ensure write access to export folder
   • Try different export location
   • Check disk space

2. Large Projects

   • Export may take time
   • Be patient
   • Check progress dialog

Problem: Images Missing in Export

Solutions:

1. Verify images are in assets/images/
2. Check image paths are relative
3. Ensure images uploaded correctly
4. Re-export project

Problem: Broken Links in Export

Solutions:

1. Use relative links only
2. Don't link to external pages
3. Check slug names match
4. Test links before export

Performance Issues

Problem: Slow Loading

Solutions:

1. Optimize Images

   • Compress large images
   • Use appropriate formats
   • Reduce image sizes

2. Reduce Page Count

   • Split large pages
   • Remove unused pages
   • Archive old content

Problem: Editor Lag

Solutions:

1. Reduce page content size
2. Close other applications
3. Use a faster computer

Data Loss Issues

Problem: Projects Disappeared

Symptoms:

• Project list is empty
• Recent projects not showing
• ezDoc looks like first run

Possible Cause: ezDoc Folder was deleted or renamed.
project data removed

Solutions:

1. Close ezDoc Studio

2. Restore folder from Backup in Windows

3. Restore from Backup in Project Manager

   • Click "Restore" button on main screen
   • Select your backup JSON file
   • Projects reappear in list
   • Re-open projects (grant folder access)

4. Manually Re-Add Projects

   • Click "Open Existing Project"
   • Navigate to project folder
   • Project is added back to list

Prevention:

• Backup regularly using "Backup" button
• Store backups in cloud storage

Startup with blank screen, only top menu available.

• Download new version greater or equal to v1.01, this was a bug with some users that has been fixed.

Report Issues

If problems persist:

1. Note exact error message
2. List steps to reproduce
3. Include OS version

Prevention Tips

Regular Backups

• Copy project folders regularly
• Use version control (Git)
• Export frequently

Best Practices

• Save often (Ctrl+S)
• Test exports regularly