The Intershop Knowledge Portal uses only technically necessary cookies. We do not track visitors or have visitors tracked by 3rd parties.
Please find further information on privacy in the Intershop Privacy Policy and Legal Notice.
Development Documents
Guidelines
17-Sep-2026
Guide - Intershop PWA - Markdown Mirrors
Document Properties
Kbid
486D41
Added to KB
17-Sep-2026
Status
online
Product
Intershop Progressive Web App
Last Modified
17-Sep-2026
Public Access
everyone
Doc Type
Guidelines
Document Link
https://knowledge.intershop.com/kb/486D41
Table Of Contents

The SSR server provides a Markdown "mirror" of every rendered page under the same URL with an added .md suffix (for example, /en/home/en/home.md).
These mirrors are intended for machine consumers, such as search crawlers and large language models (LLMs).

Accessing a Mirror

Append .md to any page path.
The mirror renders the same page and returns its main content converted to Markdown with Content-Type: text/markdown; charset=UTF-8.
Each HTML page also advertises its mirror through a Link: </en/home.md>; rel="alternate"; type="text/markdown" response header.

What Is Included

Only the main content of the page (<main id="main-content">) is converted.
Page chrome such as header, footer, navigation, scripts, forms, and other interactive, non-content, or screen-reader-only UI elements is stripped.
The specific conversion rules and PWA-specific tweaks are described in src/ssr/html-to-markdown.ts.

Implementation

The conversion is implemented using Turndown and runs in plain Node.js without a browser DOM.
The .md route is registered in server.ts.
No configuration is required; mirrors are available whenever SSR is running.
Mirrors follow the same caching behavior as regular pages.

Disclaimer

The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Website, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.

Home
Knowledge Base
User Manuals
Product Releases
Log on to continue
This Knowledge Base document is reserved for registered customers.
Log on with your Intershop Entra ID to continue.
Write an email to supportadmin@intershop.de if you experience login issues,
or if you want to register as customer.