made Markdown flavors julia, common and github public

stdlib/Markdown/docs/src/index.md

@@ -420,6 +420,9 @@ custom flavour of Markdown can be used, but this should generally be unnecessary
 Markdown.MD
 Markdown.@md_str
 Markdown.@doc_str
+Markdown.common
+Markdown.github
+Markdown.julia
 Markdown.parse
 Markdown.html
 Markdown.latex

stdlib/Markdown/src/Common/Common.jl

@@ -5,6 +5,13 @@ abstract type MarkdownElement end
 include("block.jl")
 include("inline.jl")
 
+"""
+    const Markdown.common
+
+A constant indicating the CommonMark flavor of Markdown.
+
+See also [`Markdown.parse`](@ref), [`Markdown.github`](@ref), [`Markdown.julia`](@ref).
+"""
 @flavor common [list, indentcode, blockquote, admonition, footnote, hashheader, horizontalrule,
                 paragraph,
 

stdlib/Markdown/src/GitHub/GitHub.jl

@@ -57,6 +57,13 @@ function github_paragraph(stream::IO, md::MD)
     return true
 end
 
+"""
+    const Markdown.github
+
+A constant indicating the GitHub flavor of Markdown.
+
+See also [`Markdown.parse`](@ref), [`Markdown.common`](@ref), [`Markdown.julia`](@ref).
+"""
 @flavor github [list, indentcode, blockquote, admonition, footnote, fencedcode, hashheader,
                 github_table, github_paragraph,
 

stdlib/Markdown/src/Julia/Julia.jl

@@ -7,6 +7,13 @@
 
 include("interp.jl")
 
+"""
+    const Markdown.julia
+
+A constant indicating Julia's flavor of Markdown.
+
+See also [`Markdown.parse`](@ref), [`Markdown.common`](@ref), [`Markdown.github`](@ref).
+"""
 @flavor julia [blocktex, blockinterp, hashheader, list, indentcode, fencedcode,
                blockquote, admonition, footnote, github_table, horizontalrule, setextheader, paragraph,
 

stdlib/Markdown/src/Markdown.jl

@@ -35,7 +35,7 @@ include("render/terminal/render.jl")
 
 export @md_str, @doc_str
 
-public MD, parse
+public MD, parse, common, github, julia
 
 const MARKDOWN_FACES = [
     :markdown_header => Face(weight=:bold),
@@ -61,11 +61,14 @@ __init__() = foreach(addface!, MARKDOWN_FACES)
 parse(markdown::String; flavor = julia) = parse(IOBuffer(markdown), flavor = flavor)
 
 """
-    Markdown.parse(markdown::AbstractString) -> MD
+    Markdown.parse(markdown::AbstractString; flavor = Markdown.julia) -> MD
 
-Parse `markdown` as Julia-flavored Markdown text and return the corresponding `MD` object.
+Parse `markdown` as Markdown and return the corresponding `MD` object.
+The optional argument `flavor` indicates the Markdown flavor that is used.
+It can be `julia` (default), `common` or `github`.
 
-See also [`@md_str`](@ref).
+See also [`@md_str`](@ref),
+[`Markdown.common`](@ref), [`Markdown.github`](@ref), [`Markdown.julia`](@ref).
 """
 parse(markdown::AbstractString; flavor = julia) = parse(String(markdown), flavor = flavor)
 

stdlib/Markdown/src/parse/config.jl

@@ -74,7 +74,7 @@ const flavors = Dict{Symbol, Config}()
 
 macro flavor(name, features)
     quote
-        const $(esc(name)) = config($(mapany(esc,features.args)...))
+        Core.@__doc__ const $(esc(name)) = config($(mapany(esc,features.args)...))
         flavors[$(Expr(:quote, name))] = $(esc(name))
     end
 end

stdlib/Markdown/src/parse/parse.jl

@@ -96,9 +96,13 @@ _parse(stream::IO, block::MD; breaking = false) =
     _parse(stream, block, config(block), breaking = breaking)
 
 """
-    parse(stream::IO) -> MD
+    parse(stream::IO; flavor = Markdown.julia) -> MD
 
-Parse the content of `stream` as Julia-flavored Markdown text and return the corresponding `MD` object.
+Parse the content of `stream` as Markdown text and return the corresponding `MD` object.
+The optional argument `flavor` indicates the Markdown flavor that is used.
+It can be `julia` (default), `common` or `github`.
+
+See also [`Markdown.common`](@ref), [`Markdown.github`](@ref), [`Markdown.julia`](@ref).
 """
 function parse(stream::IO; flavor = julia)
     isa(flavor, Symbol) && (flavor = flavors[flavor])