https://issues.dlang.org/show_bug.cgi?id=15475 --- Comment #2 from Adam D. Ruppe <destructionator at gmail.com> --- my doc generator handles this correctly just saying (my doc gen even handles `---` inside comments in the samples! it is fancy.) --