Comments are useful for reminders about what actions and macros do, for crediting creators of macros and so on. I do not think they are well suited to being notes for a personal knowledge management system, which is what I imagine your "personal teaching library" to be.
May I suggest that you keep notes about each macro in a in a text file, or better still a PKM application. If you use, for instance, Obsidian, you can even have links between separate notes.
I think you would find such a ready reference convenient, easy and useful, and you wouldn't have to try to make Keyboard Maestro do something it's not designed for.