правки

ru/syntax/media.md

@@ -54,6 +54,12 @@
 
 ## Видео {#video}
 
+Чтобы добавить на страницу видео, используйте разметку:
+
+```markdown
+@[название_видеохостинга](id_видео_или_ссылка_на_него)
+```
+
 ## Видео из поддерживаемых видеохостингов
 
 {% note info %}
@@ -62,15 +68,9 @@
 
 {% endnote %}
 
-Чтобы добавить на страницу видео, используйте разметку:
-
-```markdown
-@[название_видеохостинга](id_видео_или_ссылка_на_него)
-```
-
 1\. Замените `название_видеохостинга` на название видеохостинга из списка: `yandex`, `rutube`, `vk`, `youtube`, `vimeo`, `vine`, `osf`, `prezi`.
 
-2\. Получите ссылку на видео:
+2\. Получите ссылку на видео: {#href-for-video}
 
 1. Откройте видео на видеохостинге.
 1. Найдите код для публикации видео (код можно найти при экспорте, например, в разделе «Поделиться»).
@@ -130,6 +130,20 @@ docs-viewer:
 
 ## Видео из любого видеохостинга, где есть ваш проигрыватель.
 
+1. Замените `название_видеохостинга` на название видеохостинга из списка: `yandex`, `rutube`, `vk`, `youtube`, `vimeo`, `vine`, `osf`, `prezi`.
 
+1. Получите ссылку на [видео](#href-for-video).
+
+1. Замените `id_видео_или_ссылка_на_него` на полученную ссылку.
+
+**Пример разметки:**
+
+```markdown
+@[rutube](https://rutube.ru/play/embed/c25a0402e866c6fed5347be6d7dbf9ca/)
+```
+
+**Результат:**
+
+@[rutube](https://rutube.ru/play/embed/c25a0402e866c6fed5347be6d7dbf9ca/)
 
 Ознакомиться с вариантами оформления и перечнем доступных видеохостингов можно на странице плагина [markdown-it-video](https://www.npmjs.com/package/markdown-it-video).