Syncfusion Blazor DOCX Editor
Overview
Generates production-ready C# and Razor code for integrating the Syncfusion DOCX Editor (Document Editor) into Blazor Server or WebAssembly applications. It provides ready-to-use snippets and best practices for embedding a Document Editor that supports editing, reviewing, formatting, and more.
Key Capabilities
- Document Editing: Create, edit, and view Word documents.
- Protection: Apply read-only mode, allow comments, allow form filling, enforce tracked changes,and define editable ranges.
- Review: Enable track changes (revisions) and accept/reject changes.
- Comments: Add comments, replies, and author metadata.
- Find and replace: Perform programmatic find and replace operations for automation.
- Form Fields: Insert and fill text fields, check boxes, and dropdown form fields.
Prerequisites
Quick Start Examples
Example 1: Display a basic DOCX Editor
User: "Show me code to create a Document Editor component."
Result: C# + Razor code snippet displayed
Example 2: Enable Read‑Only Restriction Mode
User: "Create a Document Editor with Read‑Only restriction mode."
Result: A Blazor snippet that creates a Document Editor with read‑only protection enabled.
Generate C# Code for the User's Project (default)
Trigger keywords: "code", "snippet", "how to", "show me", "sample", "example code", "generate code", "implement", "add to component", "configure documenteditor", "create" , "blazor document editor", "docx editor", "document editor", "track changes", "load docx", "comments", "accept changes", "protect document", "find and replace", "content control"
Workflow:
- Analyze the user's request to identify the feature (e.g., track changes, restrict editing, toolbar customization).
- Read the relevant
references/*.md file(s) to understand the APIs and code patterns for the requested feature.
- STOP before generating code. Check if the user has already chosen a delivery mode.
- If no delivery mode is chosen yet, you MUST ask the user first using this concise multiple-choice question:
"How would you like to receive the generated code?"
- Option 1: Replace the code in a specific project file (you'll need to provide the file path and confirm) - Option 2: Share the code directly in the chat window
- Only after the user selects a delivery mode, proceed to generate C# code using the APIs and snippets from
references/*.md, substituting concrete placeholders from the user's project.
- Do NOT make changes to workspace project files unless the user explicitly chose Option 1 and provided the file path with permission.
- Provide complete C# snippets and concise integration steps after delivering the code.
Refer to ## Rules section for operational constraints (output directory, temporary files, allowed libraries, etc.)
Code References
All code snippets and examples are in the references/ folder. Each file contains:
- Minimal Code — a working, ready-to-use snippet
- Placeholders — values the user must customize
- Notes — best practices, additional information to note while using that functionality, constraints
| File |
Contents |
| getting-started.md |
Initialize Document Editor in Blazor WebAssembly |
| blazor-documenteditor-server.md |
Initialize Document Editor in Blazor Server |
| blazor-documenteditor-webapp.md |
Initialize Document Editor in Blazor Web App |
| form-fields.md |
Insert, edit, and manage form fields |
| comments.md |
Add, navigate, reply to, and manage comments |
| track-changes.md |
Enable track changes and review document revisions |
| document-protection.md |
Apply document protection and editing restrictions |
| spell-check.md |
Enable and configure spell checking |
| customize-toolbar.md |
Customize and control toolbar items |
| find-and-replace.md |
Find and replace text |
| paste-formatting.md |
Preserve clipboard formatting with paste support |
Key Rules for Code Generation
- No inline code in SKILL.md — Always point to snippets in
references/*.md. This file is loaded into context for every prompt; inline code wastes tokens.
- Snippets must be tested — All code must compile and run against the current
Syncfusion.Blazor.WordProcessor NuGet package version.
- Minimal Code + Placeholders + Notes — Every reference file must include:
- Minimal Code (complete, working snippet) - Placeholders (values user must substitute — marked with {{ }} or [PLACEHOLDER]) - Notes (best practices, framework-specific adaptations, constraints)
- Share code and notes for the requirement — Never create temporary files or scripts.
- License handling — Never hardcode license keys. Point user to environment variables or config files.
- Framework adaptation — Default to C# + Razor. When user specifies framework.
- No hallucinated APIs — Use only verified Syncfusion DOCX Editor SDK method names. One wrong method breaks user trust.
Rules
- Only use Syncfusion Document Editor APIs — never recommend or use alternative Word Editor libraries.
- No temporary files — never create temporary scripts, intermediate files, or scaffolding outside the output directory
- C#-only code — all generated code must be valid C# and Razor for Blazor projects. No JavaScript, Python, or other languages.