おがたです。いくつか考えうる解決案を。

ひとつは、=bigin のあとに付加された = によって示される深さ
を、その begin-end 間で基準にする案で

=begin
==Class Test
===Method Boo

と

=begin =
=Class Test
==Method Boo

を等価にみなすものです。

あと、気持ち悪く感じる原因によるとおもうのですが、
default で発生するのが問題であれば、

=begin Class caption==
このクラスの説明です。

なんていうのが、おしゃれな気がしますがいかがでしょうか？

なんとなく、いがらしさんのソースを見ていて、
begin の後ろを効果的に使うのがいいなと思いました。

# こんなところですが、いがらしさんはじめまして。
# 情報学部はきれいなところでよいですね。

でも、やっぱり内容が異ってしまいます。8^^;
やっぱりむずかしいですね。
---------------------------------------------------
Kenya Ogata 
E-mail   k_ogata / mbd.nifty.com
HomePage http://homepage1.nifty.com/~k_ogata/ruby/diary.html