• via Digitalmars-d-bugs (24/25) Jun 01 2016 https://issues.dlang.org/show_bug.cgi?id=16112

via Digitalmars-d-bugs <digitalmars-d-bugs puremagic.com> writes:

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

          Issue ID: 16112
           Summary: Replace ddoc with markdown
           Product: D
           Version: D2
          Hardware: x86_64
                OS: Linux
            Status: NEW
          Severity: enhancement
          Priority: P1
         Component: dmd
          Assignee: nobody puremagic.com
          Reporter: greensunny12 gmail.com

Issue 16109-16111 basically only lead to the logical conclusion that we support
the full markdown feature set in ddoc and allow custom macros extensions on top
of it.

Markdown is by the far the most popular markup language. Used everyone from
Github, Stack overflow, documentation in other languages (Java, PHP) etc.

https://daringfireball.net/projects/markdown/syntax
https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet
https://en.wikipedia.org/wiki/Markdown

To give a quote from recent forum discussions

 DDOC is the single worst thing in D tooling

[1] http://forum.dlang.org/post/ni29ff$26qs$1 digitalmars.com

--