Существуют отличные стандарты документации в коде для python, например:
Которые используют хороший, простой синтаксис ReStructured/Markdown. Есть ли способ заставить emacs визуализировать ReST / Md внутри комментариев кода Python? основным режимом по-прежнему будет python.el, и будет работать обычный синтаксис python; но внутри блока комментариев ('''...'''
) это будет отображаться как своего рода уценка.