go-md-spec-check

README

Markdown Specification Checker for Go

go-md-spec-check is a simple golang package that checks if a function can convert Markdown to HTML according to the CommonMark specification.

// go 1.16+
go get github.com/KEINOS/go-md-spec-check

In the below example, mdspec.SpecCheck() runs myMarkdownParser() against about 500-600 test cases and checks that the results comply with the given version of the CommonMark specification.

import (
  "fmt"
  "log"

  "github.com/KEINOS/go-md-spec-check/mdspec"
)

func Example() {
    // Sample Markdown-to-HTML conversion function that does not do its job.
    myMarkdownParser := func(markdown string) (string, error) {
        return "<p>Hello, World!</p>", nil
    }

    // Check if the `myMarkdownParser()` complies with the CommonMark specification
    // version 0.30.
    // Choices: "v0.13", "v0.14" ... "v0.30"
    err := mdspec.SpecCheck("v0.30", myMarkdownParser)

    if err != nil {
        fmt.Println(err.Error())
    }
    // Output:
    // error 1_Tabs: the given function did not return the expected HTML result.
    // given markdown: "\tfoo\tbaz\t\tbim\n"
    // expect HTML: "<pre><code>foo\tbaz\t\tbim\n</code></pre>\n"
    // actual HTML: "<p>Hello, World!</p>"
}

• Supported CommonMark spec versions:
  • CommonMark v0.13 to v0.30 (latest)
• References on CommonMark:
  • Markdown Reference @ commonmark.org
  • CommonMark specs @ spec.commonmark.org

Statuses

Contributing

We are open to anything that helps us improve.

• Branch to PR: main
• Report an issue: issues @ GitHub
  • Please attach reproducible test cases.

License, copyright and credits

• MIT, Copyright (c) 2022 KEINOS and the go-md-spec-check contributors.