From fcb2b08cf3daf5303a6e1d7e4e13d5ad1f6ca104 Mon Sep 17 00:00:00 2001
From: Philipinho <16838612+Philipinho@users.noreply.github.com>
Date: Sat, 16 May 2026 21:53:25 +0100
Subject: [PATCH] docs(import): trim auto-embed comment

---
 .../src/integrations/import/utils/import-formatter.ts     | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/apps/server/src/integrations/import/utils/import-formatter.ts b/apps/server/src/integrations/import/utils/import-formatter.ts
index f5ce02683..ac41d5fc5 100644
--- a/apps/server/src/integrations/import/utils/import-formatter.ts
+++ b/apps/server/src/integrations/import/utils/import-formatter.ts
@@ -104,12 +104,8 @@ export function defaultHtmlFormatter($: CheerioAPI, $root: Cheerio<any>) {
   normalizeTableColumnWidths($, $root);
   applyConfluenceMarginLeftIndent($, $root);
 
-  // Auto-embed only when the <a> is the SOLE meaningful child of its parent
-  // block (the "naked URL on its own line" pattern editors use as the
-  // embed-intent signal). Otherwise body-text links to YouTube/Vimeo/Loom
-  // get silently turned into fullscreen iframes, which is rarely what the
-  // author wanted — Confluence's storage format has the `widget` macro for
-  // explicit embeds, handled separately in the API converter.
+  // Auto-embed only when the <a> is the sole meaningful child of its parent
+  // block. A link mixed with surrounding text stays an inline link.
   $root.find('a[href]').each((_, el) => {
     const $el = $(el);
     const url = $el.attr('href')!;