Эта статья совсем небольшая. Когда работаешь с широким спектром решений в проекте, то технологический стек может охватывать разные аспекты и языки. В голове все держать практически невозможно (говорю про себя). Можно спрашивать ИИ, прояснить тот или иной технический момент или сразу написать листинг. Но иногда достаточно шпаргалки (cheatsheet) в одном месте. В последнее время я начал писать документацию по своим решениям, т.к. количество и подходы реализации в виде кода стали сложными и объемными. А писать начал используя разметку markdown (.MD). Написать можно документ, но за его визуализацию отвечают функции рендеринга в HTML, когда документ приятно читать. И вот, иногда работая в Jupyter среде бывает полезно подсматривать кое-что по Python.
Вы можете создавать в Jupyter среде автономные файлы документа в разметке markdown, но для его визуализации все же надо "отрендерить" разметку в HTML. В целом есть 2 варианта реализации визуализации содержимого .md в Jupyter:
- Через магическую команду
%load _путь_файл.md. И скорее всего вы загрузите исходник (raw) документа. - Через Python-код нормального рендеринга из
.mdв HTML. Ниже напишу простую конструкцию для такой визуализации.
Итак, все как всегда очень просто, модули в Jupyter для этого все есть:
from IPython.display import Markdown
Markdown(open('путь_ваш_файл.md', encoding='utf-8').read())
В результате получаем достаточно хорошую возможность получить в ячейке справку в удобочитаемом виде в формате HTML.
