09 — Пишем содержимое в Markdown


Заголовки, списки, ссылки, изображения, таблицы и блоки кода; своя статья в файле md и предварительный просмотр

Напишем статью в Markdown с заголовками, списками, изображением и таблицей. Откроем предварительный просмотр и увидим, как текстовые обозначения превращаются в аккуратный документ.

Предыдущий урок: 08 — Соединяем страницы и создаём форму · Следующий урок: 10 — Рисуем с помощью текста: Mermaid

На сенсорном экране проведите вправо для перехода к следующему уроку, влево — к предыдущему.

Чему научимся

  • Писать заголовки, списки, ссылки и добавлять изображение.
  • Создавать таблицу и узнавать исходный файл.
  • Отделять смысл содержимого от оформления страницы.

Начинаем с синхронизации

Откройте правильную папку проекта. Сохраните предыдущую работу в файлах и в Commit, затем убедитесь, что в Source Control или Git Changes нет ожидающих изменений. Только после этого выполните Pull. Если Git сообщает о конфликте, обратитесь к учителю; не удаляйте работу и не выполняйте Force Push.

Пишем и открываем предварительный просмотр

Создайте Content/care.md. В VS Code выполните Open Preview to the Side; если работаете в Visual Studio, для предварительного просмотра можно открыть Markdown-файл в VS Code. Ссылка, начинающаяся с /, задаётся относительно сайта, поэтому проверим её, когда содержимое появится на сайте в уроке 11. Пока файл не является действующей веб-страницей.

Основной заголовок начинается с #, а нумерованный список — с 1.. Пробел и пустая строка разделяют блоки. Не нужно оборачивать каждый абзац в div.

Изменения в коде

RazorTaba/Content/care.md

Новый файл. Создайте RazorTaba/Content/care.md и вставьте следующий текст:

# לפני שמאמצים, לומדים

בעל חיים צריך **טיפול קבוע**, סביבה מתאימה ותשומת לב.

## שלוש שאלות חשובות

1. האם יש לנו זמן לטפל בכל יום?
2. מה החיה צריכה לאכול?
3. מי יכול לעזור לנו כשאנחנו לא בבית?

| צורך | מה בודקים? |
| ---: | ---: |
| סביבה | מקום בטוח ומתאים |
| טיפול | מטפל אחראי וקבוע |

![איור של שועל](/images/fox.svg)

[חזרה לדף הבית](/)

Запускаем и проверяем

  1. В предварительном просмотре есть заголовки, список и таблица.
  2. Выделенный текст отображается без звёздочек.
  3. Исходный файл читается и без предварительного просмотра.

Самостоятельное задание и проверка понимания

Напишите свою статью с двумя подзаголовками, списком и ссылкой на источник. Добавьте изображение с альтернативным текстом. Объясните, что относится к содержимому, а что — к оформлению.

После существенного изменения проверьте Diff, выполните Stage, напишите сообщение Commit о сделанных изменениях и выполните Push. Убедитесь на GitHub, что изменение появилось. За год требуется не менее 50 содержательных коммитов, в том числе если всегда работаете на одном ноутбуке.

ИИ может помочь разобраться в сообщении об ошибке и найти неисправность. Вы отвечаете за написание, проверку и объяснение кода; не поручайте агенту писать проект.


Дальше