Эта статья совсем небольшая. Когда работаешь с широким спектром решений в проекте, то технологический стек может охватывать разные аспекты и языки. В голове все держать практически невозможно (говорю про себя). Можно спрашивать ИИ, прояснить тот или иной технический момент или сразу написать листинг. Но иногда достаточно шпаргалки (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.