[add] code sample links across RichText docs

serhiipylypchuk1991 · serhiipylypchuk1991 · commit 8c89a96ada89 · 2026-06-21T22:07:11.000+03:00
- link v2.1 samples in What's new (triggers, formats, insertValue)
- add Related sample links to new v2.1 API: triggers, triggerTemplate,
  insertValue, show-suggest, insert-token, hide-suggest, and
  markdown-aware setValue
- add sample links to guides: mentions and tags, configuration,
  initialization
diff --git a/docs/api/config/trigger-template.md b/docs/api/config/trigger-template.md
@@ -65,4 +65,9 @@ new Richtext("#root", {
 
 **Change log:** The property was added in v2.1
 
+**Related samples:**
+
+- [RichText. Custom dropdown template per trigger](https://snippet.dhtmlx.com/0p3bbnhz?tag=richtext)
+- [RichText. Emoji autocomplete](https://snippet.dhtmlx.com/g5z1d868?tag=richtext)
+
 **Related articles:** [Mentions and tags](guides/mentions_and_tags.md)
diff --git a/docs/api/config/triggers.md b/docs/api/config/triggers.md
@@ -238,4 +238,13 @@ new richtext.Richtext("#root", {
 
 **Change log:** The property was added in v2.1
 
+**Related samples:**
+
+- [RichText. Mentions, tags, and async lookup](https://snippet.dhtmlx.com/nfvvfize?tag=richtext)
+- [RichText. Custom dropdown template per trigger](https://snippet.dhtmlx.com/0p3bbnhz?tag=richtext)
+- [RichText. Emoji autocomplete](https://snippet.dhtmlx.com/g5z1d868?tag=richtext)
+- [RichText. Slash commands](https://snippet.dhtmlx.com/e0mrmyam?tag=richtext)
+- [RichText. Find and highlight mentions](https://snippet.dhtmlx.com/8y6zvzh2?tag=richtext)
+- [RichText. Highlight all mentions](https://snippet.dhtmlx.com/2rbo12jx?tag=richtext)
+
 **Related articles:** [Mentions and tags](guides/mentions_and_tags.md)
diff --git a/docs/api/events/hide-suggest.md b/docs/api/events/hide-suggest.md
@@ -45,3 +45,7 @@ editor.api.on("hide-suggest", () => {
 ~~~
 
 **Change log:** The event was added in v2.1
+
+**Related sample:** [RichText. Mentions, tags, and async lookup](https://snippet.dhtmlx.com/nfvvfize?tag=richtext)
+
+**Related articles:** [Mentions and tags](guides/mentions_and_tags.md)
diff --git a/docs/api/events/insert-token.md b/docs/api/events/insert-token.md
@@ -56,4 +56,6 @@ editor.api.on("insert-token", ({ data, trigger, showTrigger }) => {
 
 **Change log:** The event was added in v2.1
 
+**Related sample:** [RichText. Mentions, tags, and async lookup](https://snippet.dhtmlx.com/nfvvfize?tag=richtext)
+
 **Related articles:** [Mentions and tags](guides/mentions_and_tags.md)
diff --git a/docs/api/events/show-suggest.md b/docs/api/events/show-suggest.md
@@ -59,4 +59,6 @@ editor.api.intercept("show-suggest", (state) => {
 
 **Change log:** The event was added in v2.1
 
+**Related sample:** [RichText. Mentions, tags, and async lookup](https://snippet.dhtmlx.com/nfvvfize?tag=richtext)
+
 **Related articles:** [Mentions and tags](guides/mentions_and_tags.md)
diff --git a/docs/api/methods/insert-value.md b/docs/api/methods/insert-value.md
@@ -43,3 +43,8 @@ editor.insertValue("<a href=\"https://example.com\" title=\"Example\">link</a>")
 The inserted content is added as a single history entry and can be reverted with one **Undo** step.
 
 **Change log:** The method was added in v2.1
+
+**Related samples:**
+
+- [RichText. Insert content at cursor](https://snippet.dhtmlx.com/pew2g1ku?tag=richtext)
+- [RichText. Working with different formats (Markdown, HTML, text)](https://snippet.dhtmlx.com/cne4kujn?tag=richtext)
diff --git a/docs/api/methods/set-value.md b/docs/api/methods/set-value.md
@@ -43,3 +43,5 @@ editor.setValue(editor_value, fromTextEncoder);
 ~~~
 
 **Change log:** The method was updated in v2.0. The `mode` parameter was removed. The `encoder` parameter was added
+
+**Related sample:** [RichText. Working with different formats (Markdown, HTML, text)](https://snippet.dhtmlx.com/cne4kujn?tag=richtext)
diff --git a/docs/guides/configuration.md b/docs/guides/configuration.md
@@ -42,6 +42,8 @@ const editor = new richtext.Richtext("#root", {
 });
 ~~~
 
+**Related sample:** [RichText. Document and classic modes](https://snippet.dhtmlx.com/jz8q432l?tag=richtext)
+
 ## Toolbar
 
 The RichText toolbar groups controls into several blocks that you can customize.
@@ -125,7 +127,7 @@ new richtext.Richtext("#root", {
 });
 ~~~
 
-**Related sample:** [RichText. Custom control and simplified toolbar](https://snippet.dhtmlx.com/wda202ih?tag=richtext)
+**Related sample:** [RichText. Full toolbar](https://snippet.dhtmlx.com/ziynafp7?tag=richtext)
 
 ### Add custom toolbar controls
 
@@ -202,6 +204,8 @@ new richtext.Richtext("#root", {
 });
 ~~~
 
+**Related sample:** [RichText. Initialization with menubar](https://snippet.dhtmlx.com/tjryzka7?tag=richtext)
+
 ## Set the initial content
 
 Use the [`value`](api/config/value.md) property to pass initial HTML content into the editor on initialization:
@@ -215,6 +219,8 @@ new richtext.Richtext("#root", {
 
 To replace the content after initialization, or to load it in a non-HTML format with a custom encoder, call the [`setValue()`](api/methods/set-value.md) method.
 
+**Related sample:** [RichText. Working with different formats (Markdown, HTML, text)](https://snippet.dhtmlx.com/cne4kujn?tag=richtext)
+
 ## Set the initial locale
 
 Use the [`locale`](api/config/locale.md) property to apply a localization object on initialization:
diff --git a/docs/guides/initialization.md b/docs/guides/initialization.md
@@ -76,3 +76,5 @@ editor.destructor();
 The example below initializes RichText with the menubar enabled:
 
 <iframe src="https://snippet.dhtmlx.com/tjryzka7?mode=js" frameborder="0" class="snippet_iframe" width="100%" height="500"></iframe>
+
+**Related sample:** [RichText. Initialization](https://snippet.dhtmlx.com/t55alxiy?tag=richtext)
diff --git a/docs/guides/mentions_and_tags.md b/docs/guides/mentions_and_tags.md
@@ -54,6 +54,8 @@ Each trigger is an object `{ trigger, data, showTrigger?, action? }` within the
 }
 ~~~
 
+**Related sample:** [RichText. Mentions, tags, and async lookup](https://snippet.dhtmlx.com/nfvvfize?tag=richtext)
+
 ## Token rendering
 
 When the user picks an item from the dropdown, RichText inserts it as an `<a>` element with two data attributes:
@@ -78,6 +80,11 @@ You can style tokens with the `data-token` selector:
 }
 ~~~
 
+**Related samples:**
+
+- [RichText. Find and highlight mentions](https://snippet.dhtmlx.com/8y6zvzh2?tag=richtext)
+- [RichText. Highlight all mentions](https://snippet.dhtmlx.com/2rbo12jx?tag=richtext)
+
 ## Hide the trigger character
 
 Set `showTrigger: false` on a trigger to insert only the item label, without the trigger symbol:
@@ -136,6 +143,8 @@ new richtext.Richtext("#root", {
 });
 ~~~
 
+**Related sample:** [RichText. Custom dropdown template per trigger](https://snippet.dhtmlx.com/0p3bbnhz?tag=richtext)
+
 ## Custom action on select
 
 By default, picking an item inserts it into the document as a token. To run your own code instead, add an `action` callback to the trigger. RichText removes the typed trigger text and calls `action(item)` with the picked item — no token is inserted, so you can decide what to add.
@@ -180,6 +189,8 @@ function emojiFromCode(code) {
 }
 ~~~
 
+**Related sample:** [RichText. Emoji autocomplete](https://snippet.dhtmlx.com/g5z1d868?tag=richtext)
+
 ### Group emoji by categories
 
 When the `data` parameter is a function, you are not limited to the built-in `label` matching. You can run your own filtering and keep category headers in the dropdown. Add header items that include a `label` field and do not include `code`. The `data` function first finds the emoji that match the query, then returns emoji together with the headers of the categories that still have matches:
@@ -252,6 +263,8 @@ const editor = new richtext.Richtext("#root", {
 });
 ~~~
 
+**Related sample:** [RichText. Slash commands](https://snippet.dhtmlx.com/e0mrmyam?tag=richtext)
+
 ## Related API
 
 - [`triggers`](api/config/triggers.md)
diff --git a/docs/news/whats_new.md b/docs/news/whats_new.md
@@ -12,10 +12,10 @@ Released on June X, 2026
 
 - The [`imageUploadUrl`](api/config/image-upload-url.md) is optional: when omitted, images are inserted inline as base64 data URLs with no server required
 - Drag-and-drop image insertion: drop an image file directly into the editor area
-- Markdown support: parse and serialize editor content as Markdown via the `markdown` encoder in [`setValue()`](api/methods/set-value.md), [`getValue()`](api/methods/get-value.md), and [`insertValue()`](api/methods/insert-value.md) methods
-- Mentions, tags, and custom dropdown triggers via the [`triggers`](api/config/triggers.md) property: type a character such as `@`, `#`, `/`, or `:` to open a suggestion dropdown and insert the selected item as a non-editable token (see the [Mentions and tags](guides/mentions_and_tags.md) guide)
-- Custom rendering for suggestion items through the [`triggerTemplate`](api/config/trigger-template.md) property (for example, an avatar with a name and an email)
-- Custom action when a user selects a trigger: run your own code (insert an emoji, trigger a slash-style command, and more) instead of inserting a token
+- Markdown support: parse and serialize editor content as Markdown via the `markdown` encoder in [`setValue()`](api/methods/set-value.md), [`getValue()`](api/methods/get-value.md), and [`insertValue()`](api/methods/insert-value.md) methods (see the [RichText. Working with different formats (Markdown, HTML, text)](https://snippet.dhtmlx.com/cne4kujn?tag=richtext) sample)
+- Mentions, tags, and custom dropdown triggers via the [`triggers`](api/config/triggers.md) property: type a character such as `@`, `#`, `/`, or `:` to open a suggestion dropdown and insert the selected item as a non-editable token (see the [Mentions and tags](guides/mentions_and_tags.md) guide and the [RichText. Mentions, tags, and async lookup](https://snippet.dhtmlx.com/nfvvfize?tag=richtext) sample)
+- Custom rendering for suggestion items through the [`triggerTemplate`](api/config/trigger-template.md) property (for example, an avatar with a name and an email) (see the [RichText. Custom dropdown template per trigger](https://snippet.dhtmlx.com/0p3bbnhz?tag=richtext) sample)
+- Custom action when a user selects a trigger: run your own code (insert an emoji, trigger a slash-style command, and more) instead of inserting a token (see the [RichText. Emoji autocomplete](https://snippet.dhtmlx.com/g5z1d868?tag=richtext) and [RichText. Slash commands](https://snippet.dhtmlx.com/e0mrmyam?tag=richtext) samples)
 - Clipboard support (copy, cut, and paste) that preserves formatting between RichText instances and inserts external content as plain text
 - Word- and line-scope deletion shortcuts: delete the previous/next word with `Ctrl+Backspace` / `Ctrl+Delete` (Windows/Linux) or `Opt+Backspace` / `Opt+Delete` (macOS); delete the previous/next visual line with `Cmd+Backspace` / `Cmd+Delete` (macOS only)
 
@@ -28,7 +28,7 @@ Released on June X, 2026
 
 #### New methods
 
-- [`insertValue()`](api/methods/insert-value.md) — Inserts text, Markdown, or HTML content at the cursor position or replaces the selected text
+- [`insertValue()`](api/methods/insert-value.md) — Inserts text, Markdown, or HTML content at the cursor position or replaces the selected text (see the [RichText. Insert content at cursor](https://snippet.dhtmlx.com/pew2g1ku?tag=richtext) sample)
 
 #### New events
 
