https://issues.dlang.org/show_bug.cgi?id=19814

          Issue ID: 19814
           Summary: Nested code blocks in Ddoc are break formatting
           Product: D
           Version: D2
          Hardware: All
                OS: All
            Status: NEW
          Severity: minor
          Priority: P1
         Component: dmd
          Assignee: nobody@puremagic.com
          Reporter: gileadis@gmail.com

This bug is caused by the Markdown support I recently added. It happens regardless of whether the -preview=markdown flag is passed to the compiler. A test case, from ddoc.dd (the test case includes the outside code fences):

------------------------------------
/**
 * Examples:
 * --------------------
 * writeln("3"); // writes '3' to stdout
 * --------------------
 */
------------------------------------

This should render as one code example with a documentation comment inside it that itself describes a code example. Instead, it renders as two code examples with an oddly formatted "writeln" between them.

I have a fix prepared.

--