doc.go 995 B

1234567891011121314151617181920212223242526272829303132333435
  1. /*
  2. Package markdown implements markdown parser and HTML renderer.
  3. It parses markdown into AST format which can be serialized to HTML
  4. (using html.Renderer) or possibly other formats (using alternate renderers).
  5. Convert markdown to HTML
  6. The simplest way to convert markdown document to HTML
  7. md := []byte("## markdown document")
  8. html := markdown.ToHTML(md, nil, nil)
  9. Customizing parsing and HTML rendering
  10. You can customize parser and HTML renderer:
  11. import (
  12. "github.com/gomarkdown/markdown/parser"
  13. "github.com/gomarkdown/markdown/renderer"
  14. "github.com/gomarkdown/markdown"
  15. )
  16. extensions := parser.CommonExtensions | parser.AutoHeadingIDs
  17. p := parser.NewWithExtensions(extensions)
  18. htmlFlags := html.CommonFlags | html.HrefTargetBlank
  19. opts := html.RendererOptions{Flags: htmlFlags}
  20. renderer := html.NewRenderer(opts)
  21. md := []byte("markdown text")
  22. html := markdown.ToHTML(md, p, renderer)
  23. For a cmd-line tool see https://github.com/gomarkdown/mdtohtml
  24. */
  25. package markdown