diff --git a/ru/syntax/media.md b/ru/syntax/media.md
index 9e7ba773..16c40b11 100644
--- a/ru/syntax/media.md
+++ b/ru/syntax/media.md
@@ -56,7 +56,7 @@
 
 Поддерживаются все сервисы, в которых есть медиапроигрыватели.
 
-Чтобы добавить на страницу видео:
+Для вставки видео на страницу:
 
 1. используйте разметку: 
 
@@ -64,16 +64,16 @@
     @[название_видеохостинга](id_видео_или_ссылка_на_него)
     ```
 
-1. Замените `название_видеохостинга` на значение:
+1. Замените `название_видеохостинга` на значение, соответствующее вашему видеохостингу:
 
-    - YouTube — youtube
-    - Vimeo — vimeo
-    - Vine — vine
-    - Prezi — prezi
-    - Osf — osf
-    - Yandex — yandex
-    - Vk — vk
-    - Rutube — rutube
+    - Для YouTube используйте `youtube`.
+    - Для Vimeo используйте `vimeo`.
+    - Для Vine используйте `vine`.
+    - Для Prezi используйте `prezi`.
+    - Для Osf используйте `osf`.
+    - Для Yandex используйте `yandex`.
+    - Для Vk используйте `vk`.
+    - Для Rutube используйте `rutube`.
 
 1. Получите ссылку на видео.
 
@@ -102,6 +102,8 @@
 
     {% endcut %}
 
+    1. Замените `id_видео_или_ссылка_на_него` полученной ссылкой.
+
 Ознакомиться с вариантами оформления и перечнем доступных видеохостингов можно на странице плагина [markdown-it-video](https://www.npmjs.com/package/markdown-it-video).