From 573f07a27d070bc27d40b01ee476d08b7bc42a03 Mon Sep 17 00:00:00 2001
From: Bugo <cheetah@bk.ru>
Date: Sun, 9 Mar 2025 13:16:58 +0500
Subject: [PATCH] Update ru/guide/markdown.md

---
 docs/ru/guide/markdown.md | 51 +++++++++++++++++++++++++++++++++++++--
 1 file changed, 49 insertions(+), 2 deletions(-)

diff --git a/docs/ru/guide/markdown.md b/docs/ru/guide/markdown.md
index 192bd2f8..4da19d61 100644
--- a/docs/ru/guide/markdown.md
+++ b/docs/ru/guide/markdown.md
@@ -844,7 +844,7 @@ export default config
 Может быть создана с помощью `.foorc.json`.
 ```
 
-**Эквивалентный код**
+**Соответствующий код**
 
 ```md
 # Документация
@@ -883,7 +883,7 @@ export default config
 <!-- #endregion basic-usage -->
 ```
 
-**Эквивалентный код**
+**Соответствующий код**
 
 ```md
 # Документация
@@ -899,6 +899,53 @@ export default config
 Обратите внимание, что это не приводит к ошибкам, если ваш файл отсутствует. Поэтому при использовании этой функции убедитесь, что содержимое отображается так, как ожидается.
 :::
 
+Вместо регионов VS Code вы также можете использовать якоря заголовков, чтобы включить определённый раздел файла. Например, если у вас есть заголовок в вашем markdown-файле, например:
+
+```md
+## Мой основной раздел
+
+Какой-то контент здесь.
+
+### Мой подраздел
+
+Ещё немного контента здесь.
+
+## Другой раздел
+
+Контент вне `Моего основного раздела`.
+```
+
+Вы можете включить раздел `Мой основной раздел` следующим образом:
+
+```md
+## Мой дополнительный раздел
+<!--@include: ./parts/basics.md#my-base-section-->
+```
+
+**Соответствующий код**
+
+```md
+## Мой дополнительный раздел
+
+Какой-то контент здесь.
+
+### Мой подраздел
+
+Ещё немного контента здесь.
+```
+
+Здесь `my-base-section` — это сгенерированный идентификатор элемента заголовка. Если его нелегко угадать, вы можете открыть файл в браузере и нажать на якорь заголовка (символ `#` слева от заголовка при наведении), чтобы увидеть идентификатор в адресной строке. Или используйте инструменты разработчика браузера для проверки элемента. Кроме того, вы также можете указать идентификатор для файла части следующим образом:
+
+```md
+## Мой основной раздел {#custom-id}
+```
+
+и включить его следующим образом:
+
+```md
+<!--@include: ./parts/basics.md#custom-id-->
+```
+
 ## Математические уравнения {#math-equations}
 
 В настоящее время эта фича предоставляется по желанию. Чтобы включить её, вам нужно установить `markdown-it-mathjax3` и установить значение `true` для опции `markdown.math` в вашем файле конфигурации: