bug: superdoc webpage misrendered text (SD-1819) by luccas-harbour · Pull Request #1988 · superdoc-dev/superdoc

luccas-harbour · 2026-02-10T17:49:29Z

There was an issue that happened during export if a linked style contained an ampersand. The issue was that if that character was represented as &, the ampersand would be double-escaped, turning into &amp;
The sdpr.docx test document had been exported from SD and because of that had the incorrect &amp; entity. This had to be fixed manually.

linear · 2026-02-10T17:49:32Z

SD-1819 SuperDoc Webpage - misrendered text

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f9deb7955a

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

packages/super-editor/src/core/Editor.ts

caio-pizzol

Looks good! Just 2 comments

packages/super-editor/src/core/Editor.ts

caio-pizzol

LGTM!

VladaHarbour · 2026-02-11T13:55:10Z

lgtm

superdoc-bot · 2026-02-11T17:34:02Z

🎉 This PR is included in superdoc v1.12.0-next.12

The release is available on GitHub release

harbournick · 2026-02-12T17:45:08Z

🎉 This PR is included in superdoc v1.12.0

The release is available on GitHub release

…d delInstrText Two sources of Word "unreadable content" error on exported files: 1. Revert #replaceSpecialCharacters regex to simple .replace(/&/g, '&'). The negative lookahead from PR #1988 incorrectly treated decoded entity-like text (e.g. literal ") as already-encoded, collapsing distinct style names into duplicates in styles.xml. 2. Normalize w:delInstrText → w:instrText in the exporter. During round-trip, w:del wrappers around field char runs lose their trackDelete marks (only text content gets marked), leaving w:delInstrText orphaned outside w:del — which violates ECMA-376 §17.16.13. SD-1943

…d delInstrText (SD-1943) (#2102) * fix(export): prevent DOCX corruption from entity encoding and orphaned delInstrText Two sources of Word "unreadable content" error on exported files: 1. Revert #replaceSpecialCharacters regex to simple .replace(/&/g, '&'). The negative lookahead from PR #1988 incorrectly treated decoded entity-like text (e.g. literal ") as already-encoded, collapsing distinct style names into duplicates in styles.xml. 2. Normalize w:delInstrText → w:instrText in the exporter. During round-trip, w:del wrappers around field char runs lose their trackDelete marks (only text content gets marked), leaving w:delInstrText orphaned outside w:del — which violates ECMA-376 §17.16.13. SD-1943 * fix(export): remove double entity encoding of .rels relationship targets

# [1.15.0](v1.14.0...v1.15.0) (2026-02-20) ### Bug Fixes * **ai-actions:** preserve html/markdown insertion and prevent repeated formatted replacement ([#2117](#2117)) ([9f685e9](9f685e9)) * **ai:** support headless mode in EditorAdapter.applyPatch ([#1859](#1859)) ([cf9275d](cf9275d)) * **collaboration:** memory leaks, Vue stack overflow, and Liveblocks stability (SD-1924) ([#2030](#2030)) ([a6827fd](a6827fd)), closes [#prepareDocumentForExport](https://github.com/superdoc-dev/superdoc/issues/prepareDocumentForExport) * **collab:** prevent stale view when remote Y.js changes bypass sdBlockRev increment ([#2099](#2099)) ([0895a93](0895a93)) * **converter:** handle null list lvlText and always clear numbering cache ([#2113](#2113)) ([336958c](336958c)) * **document-api:** remove search match cap and validate moveComment bounds ([6d3de67](6d3de67)) * export docx blobs with docx mime type ([#1849](#1849)) ([1bc466d](1bc466d)) * **export:** prevent DOCX corruption from entity encoding and orphaned delInstrText (SD-1943) ([#2102](#2102)) ([56e917f](56e917f)), closes [#replaceSpecialCharacters](https://github.com/superdoc-dev/superdoc/issues/replaceSpecialCharacters) [#1988](#1988) * **layout-bridge:** correct cell selection for tables with rowspan ([#1839](#1839)) ([0b782be](0b782be)) * **layout,converter:** text box rendering and page-relative anchor positioning (SD-1331, SD-1838) ([#2034](#2034)) ([3947f39](3947f39)) * **layout:** route list text-start calculations through resolveListTextStartPx ([02b14b8](02b14b8)) * **painter-dom:** use absolute page Y for page-relative anchors in header/footer decorations ([0b9bc72](0b9bc72)) * preserve selection highlight when opening toolbar dropdowns ([#2097](#2097)) ([a33568e](a33568e)) * structured content renders correct on hover and select ([#1843](#1843)) ([dab3f04](dab3f04)) * **super-editor:** add unsupported-content reporting across HTML/Markdown import paths ([#2115](#2115)) ([84880b7](84880b7)) * **super-editor:** handle partial comment file-sets and clean up stale parts on export ([#2123](#2123)) ([f63ae0a](f63ae0a)) * **super-editor:** restore <hr> contentBlock parsing and harden VML HR export fallback ([#2118](#2118)) ([da51b1f](da51b1f)) * table headers are incorrectly imported from html ([#2112](#2112)) ([e8d1480](e8d1480)) * table resizing regression ([#2091](#2091)) ([20ed24e](20ed24e)) * table resizing regression ([#2091](#2091)) ([9a07f1c](9a07f1c)) * **tables:** align tableHeader attrs with tableCell to fix oversized DOCX export widths ([#2114](#2114)) ([38f0430](38f0430)) * **tables:** fix autofit column scaling, cell width overflow, and page break splitting ([#1987](#1987)) ([61a3f6f](61a3f6f)) * **tables:** prevent tblInd double-shrink when using tblGrid widths (SD-1494) ([8750ece](8750ece)) * track changes comment text for formatting changes ([#2013](#2013)) ([b2a43ff](b2a43ff)) * wire DocumentApi to Editor.doc with lifecycle-safe caching ([57326ea](57326ea)) ### Features * cropped images ([#1940](#1940)) ([3767a49](3767a49)) * extend document-api with format, examples, create.heading ([#2092](#2092)) ([fdf8c7c](fdf8c7c)) * **lists:** support hidden list indicators via w:vanish ([#2069](#2069)) ([#2080](#2080)) ([0bed0fd](0bed0fd)) * the document API limited alpha ([#2087](#2087)) ([091c24c](091c24c))

luccas-harbour added 2 commits February 10, 2026 14:44

fix: correctly escape HTML entities in styles.xml during export

99528b1

fix: test document styles

f9deb79

luccas-harbour requested review from caio-pizzol and harbournick February 10, 2026 17:51

luccas-harbour marked this pull request as ready for review February 10, 2026 18:00

chatgpt-codex-connector bot reviewed Feb 10, 2026

View reviewed changes

packages/super-editor/src/core/Editor.ts Outdated Show resolved Hide resolved

fix: only allow valid XML entities in styles.xml

5c9921b

caio-pizzol assigned luccas-harbour Feb 10, 2026

caio-pizzol reviewed Feb 10, 2026

View reviewed changes

packages/super-editor/src/core/Editor.ts Outdated Show resolved Hide resolved

packages/super-editor/src/core/Editor.ts Show resolved Hide resolved

caio-pizzol requested a review from VladaHarbour February 10, 2026 23:06

fix: remove double encoding of HTML entities

2fa5830

luccas-harbour requested a review from caio-pizzol February 11, 2026 13:46

caio-pizzol enabled auto-merge (squash) February 11, 2026 13:50

caio-pizzol approved these changes Feb 11, 2026

View reviewed changes

fix: add guard in HTML entity replacement regex

e70be3b

luccas-harbour force-pushed the luccas/sd-1819-superdoc-webpage-misrendered-text branch from 6135a23 to e70be3b Compare February 11, 2026 13:54

VladaHarbour approved these changes Feb 11, 2026

View reviewed changes

caio-pizzol merged commit aecc70d into main Feb 11, 2026
2 checks passed

caio-pizzol deleted the luccas/sd-1819-superdoc-webpage-misrendered-text branch February 11, 2026 14:03

superdoc-bot bot added the released on @next label Feb 11, 2026

harbournick added the released on @latest label Feb 12, 2026

caio-pizzol mentioned this pull request Feb 18, 2026

fix(export): prevent DOCX corruption from entity encoding and orphaned delInstrText (SD-1943) #2102

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Comments

bug: superdoc webpage misrendered text (SD-1819)#1988

bug: superdoc webpage misrendered text (SD-1819)#1988
caio-pizzol merged 5 commits intomainfrom
luccas/sd-1819-superdoc-webpage-misrendered-text

luccas-harbour commented Feb 10, 2026

Uh oh!

linear bot commented Feb 10, 2026

Uh oh!

chatgpt-codex-connector bot left a comment

Uh oh!

Uh oh!

caio-pizzol left a comment

Uh oh!

Uh oh!

Uh oh!

caio-pizzol left a comment

Uh oh!

VladaHarbour commented Feb 11, 2026

Uh oh!

Uh oh!

superdoc-bot bot commented Feb 11, 2026

Uh oh!

harbournick commented Feb 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Comments

Conversation

luccas-harbour commented Feb 10, 2026

Uh oh!

linear bot commented Feb 10, 2026

Uh oh!

chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

caio-pizzol left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

caio-pizzol left a comment

Choose a reason for hiding this comment

Uh oh!

VladaHarbour commented Feb 11, 2026

Uh oh!

Uh oh!

superdoc-bot bot commented Feb 11, 2026

Uh oh!

harbournick commented Feb 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants