On Dec 6, 2004, at 2:31, Joel VanderWerf wrote: > > I'm trying to embed YAML output in a simple markup file (not a ruby > code file) that gets fed into RDoc. I want the YAML text to show up as > a literal. So I indent. For instance: > > --- > foo: > :bar: 3 > > The problem is that the :bar: causes RDoc to complain about an > "Unrecognized directive". Sorry about that. It's a hole in the way RDoc handles directives. At the point it is scanning for them, it hasn't yet done the analysis on the internal structure of the comment block, so it doesn't know that your :bar: is in a literal code block. Cheers Dave