Try parsing a markdown String into Markdown.Block.Blocks.

Often you'll want to render these Blocks directly:

render renderer markdown =
    markdown
        |> Markdown.Parser.parse
        |> Result.mapError deadEndsToString
        |> Result.andThen (\ast -> Markdown.Renderer.render renderer ast)


deadEndsToString deadEnds =
    deadEnds
        |> List.map Markdown.Parser.deadEndToString
        |> String.join "\n"

But you can also do a lot with the Blocks before passing them through:

• Transform the Blocks (example: make each heading one level deeper)
• Use the blocks to gather metadata about the markdown document (example: building a table of contents from Blocks)

Turn a parsing problem into the default String representation.