Markdown, формулы и диаграммы
Файлы .md показываются с разметкой: заголовки, списки, таблицы, код, формулы LaTeX, диаграммы mermaid, ссылки на файлы репозитория и вики-ссылки.
В этой статье
Основы#
Skillok показывает markdown как GitHub: заголовки #, списки, жирный и курсив, цитаты >,
таблицы с |, код в ``` с указанием языка для подсветки, чекбоксы - [ ]. У каждого
заголовка есть якорь — на раздел можно дать ссылку.
Формулы#
Формулы пишутся в нотации LaTeX: строчная — $E = mc^2$, выключная — между $$ на отдельных
строках:
$$
\int_0^1 x^2\,dx = \frac{1}{3}
$$
Так же формулы понимают уроки курсов и задачи практики.
Диаграммы#
Блок кода с языком mermaid рисуется диаграммой — схемой, последовательностью, графом.
Скрипт диаграмм подгружается только на страницах, где такой блок есть.
Ссылки и картинки#
- Относительная ссылка на файл репозитория —
[конспект](../fizika/zakon-oma.md)— ведёт на страницу этого файла в той же ветке. - Картинка
показывается из репозитория. - Вики-ссылка
[[Закон Ома]]находит файл по имени во всём репозитории — удобно для заметок. - Внешние ссылки открываются как есть.
Что не рендерится#
Скрипты и опасная разметка из файла вырезаются при показе — это защита читателя, а не ограничение автора: сам файл хранится нетронутым.
Было полезно?