J'opterais plutôt pour délimiter le synopsis au premier paragraph reconnu par Markdown. Surtout si j'ai bien compris et qu'on commence à cacher la doc non-synopsis dans les redefs. On a déjà le module, classe et nom de méthode pour la définition très courte, il faut avoir plus de jeu dans le synopsis, ce n'est pas un titre non plus.

J'ai ajouté l'exemple en réponse à #182. Sans l'exemple je crains que ça reste incompréhensible. Je vais tout de même trouver qqc à couper pour n'utiliser qu'une ligne.