Troubleshooting Export Issues

Solutions for common image rendering and Markdown documentation export problems.

1. Exported PNG Appears Blurry on High-DPI Displays

Solution

When clicking Export in the top navigation bar, ensure Image Quality / Resolution is set to 2x or 3x. This renders the diagram at high pixel density, ensuring that text and vector icons remain crisp on Retina displays, 4K monitors, and presentation slides.

2. Transparent vs. White Background

Issue

Exporting a diagram to embed in dark-themed wikis or transparent slides results in a bright white box.

Solution

In the Export dialog, toggle Background to Transparent. Rekhic will omit the background canvas color, allowing the resulting PNG to blend seamlessly into dark or light slides.

3. Markdown Export Missing Certain Nodes

Cause

The Markdown generator extracts structured architecture components (applications, services, databases, external systems, and connected edges). Freehand drawing strokes or loose text labels that are not connected to any component are omitted to keep the Markdown specification concise.

Solution

• Ensure services are placed using Architecture Nodes or standard shapes.
• Connect related nodes using connector arrows so relationships are captured in the ## Relationships / Data Flow table.