From 56f2b7797e38e2653cf5a64a19d6ed52d5108a6c Mon Sep 17 00:00:00 2001
From: Bugo <cheetah@bk.ru>
Date: Tue, 8 Oct 2024 11:53:53 +0500
Subject: [PATCH] Update ru/guide/markdown.md

---
 docs/ru/guide/markdown.md | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/docs/ru/guide/markdown.md b/docs/ru/guide/markdown.md
index a021cd18..ffc66f51 100644
--- a/docs/ru/guide/markdown.md
+++ b/docs/ru/guide/markdown.md
@@ -210,7 +210,7 @@ console.log('Привет, VitePress!')
 
 :::
 
-Кроме того, вы можете установить пользовательские заголовки глобально, добавив следующее содержимое в конфигурацию сайта, полезное, если вы пишете не на английском языке:
+Кроме того, можно установить пользовательские заголовки глобально, добавив следующее содержимое в конфигурацию сайта, полезное, если вы пишете не на английском языке:
 
 ```ts
 // config.ts
@@ -269,7 +269,7 @@ export default defineConfig({
 
 ## Оповещения в стиле GitHub {#github-flavored-alerts}
 
-VitePress также поддерживает [Оповещения в стиле GitHub](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts) для отображения в виде призывов. Они будут отображаться так же, как и [пользовательские контейнеры](#custom-containers).
+VitePress также поддерживает [Оповещения в стиле GitHub](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts) для отображения в виде вставок. Они будут отображаться так же, как и [пользовательские контейнеры](#custom-containers).
 
 ```md
 > [!NOTE]
@@ -305,7 +305,7 @@ VitePress также поддерживает [Оповещения в стил
 
 ## Подсветка синтаксиса в блоках кода {#syntax-highlighting-in-code-blocks}
 
-VitePress использует [Shiki](https://github.com/shikijs/shiki) для выделения синтаксиса языка в блоках кода Markdown с помощью цветного текста. Shiki поддерживает широкий спектр языков программирования. Всё, что вам нужно сделать, это добавить правильный псевдоним языка к начальным значкам блока кода:
+VitePress использует [Shiki](https://github.com/shikijs/shiki) для выделения синтаксиса языка в блоках кода Markdown с помощью цветного текста. Shiki поддерживает широкий спектр языков программирования. Всё, что вам нужно сделать, это добавить правильный псевдоним языка к начальным обратным кавычкам блока кода:
 
 **Разметка**
 
@@ -375,7 +375,7 @@ export default {
 }
 ```
 
-Помимо одной строки, вы можете указать несколько отдельных строк, диапазонов или и то, и другое:
+Помимо одной строки, можно указать несколько отдельных строк, диапазонов или и то, и другое:
 
 - Диапазоны строк, например: `{5-8}`, `{3-10}`, `{10-17}`
 - Несколько одиночных строк, например: `{4,7,9}`
@@ -477,7 +477,7 @@ export default {
 
 ## Подсветка различий в блоках кода {#colored-diffs-in-code-blocks}
 
-Добавление в строку комментариев `// [!code --]` или `// [!code ++]` создаст diff этой строки, сохраняя цвета блока кода.
+Добавление в строку комментариев `// [!code --]` или `// [!code ++]` подсветит различие этой строки от другой, сохраняя цвета блока кода.
 
 **Разметка**
 
@@ -553,9 +553,9 @@ export default {
 
 Более подробную информацию см. в секции [`markdown`](../reference/site-config#markdown).
 
-Вы можете добавить метки `:line-numbers` / `:no-line-numbers` в ваши ограждённые блоки кода, чтобы переопределить значение, установленное в конфиге.
+Вы можете добавить метки `:line-numbers` / `:no-line-numbers` в ваши изолированные блоки кода, чтобы переопределить значение, установленное в конфиге.
 
-Вы также можете настроить номер начальной строки, добавив `=` после `:line-numbers`. Например, `:line-numbers=2` означает, что номера строк в блоках кода будут начинаться с `2`.
+Вы также можете настроить номер начальной строки, добавив `=` после `:line-numbers`. Например, `:line-numbers=2` означает, что нумерация строк в блоках кода будет начинаться с `2`.
 
 **Разметка**
 
@@ -628,7 +628,7 @@ const line4 = 'Строка 4'
 <<< @/snippets/snippet.js{2}
 
 ::: tip СОВЕТ
-Значение `@` соответствует корню источника. По умолчанию это корень проекта VitePress, если не настроен `srcDir`. Альтернативно вы также можете импортировать из относительных путей:
+Значение `@` соответствует корню источника. По умолчанию это корень проекта VitePress, если не настроен параметр `srcDir`. Альтернативно вы также можете импортировать из относительных путей:
 
 ```md
 <<< ../snippets/snippet.js
@@ -652,7 +652,7 @@ const line4 = 'Строка 4'
 
 <<< @/snippets/snippet-with-region.js#snippet{1}
 
-Вы также можете указать язык внутри фигурных скобок (`{}`) следующим образом:
+Кроме того, можно указать язык внутри фигурных скобок (`{}`) следующим образом:
 
 ```md
 <<< @/snippets/snippet.cs{c#}
@@ -670,7 +670,7 @@ const line4 = 'Строка 4'
 
 ## Группы кодов {#code-groups}
 
-Вы можете сгруппировать несколько блоков кода следующим образом:
+Можно сгруппировать несколько блоков кода следующим образом:
 
 **Разметка**