Lint all JavaScript in markdown files by default

[feross]

ESLint supports the notion of "processors" which allows us to extract JS from markdown files and lint it to ensure it is in standard style. https://eslint.org/docs/user-guide/configuring#specifying-processor

That would let us eliminate this whole section of the readme which describes how to install eslint-plugin-markdown, run standard with the --plugin flag. In the end you need to actually run standard twice if you do this: standard && standard --plugin markdown '**/*.md'

I think we can do better. Let's just do the right thing out of the box.

We should probably do the same for <script> tags in HTML files too, while we're at it.

We can provide a --no-md or --no-html escape hatch for those who need it. But ideally, this just does the right thing 99.9% of the time.

Thoughts?

[mightyiam]

Brilliant. I'd love that. Would probably break some projects.

Would that be supported merely by extending from eslint-config-standard or would it require the executable? I would prefer the former, if possible.

[feross]

We'd put it directly in eslint-config-standard.

[vweevers]

We should probably do the same for <script> tags in HTML files too, while we're at it.

One requirement for this is that generated HTML (like a code coverage report) is excluded. Such HTML is typically git-ignored though, which tells standard to ignore it too, so it's probably fine.

[vweevers]

I've seen and written code examples in READMEs that are not 100% correct, for example to quickly demonstrate two ways to achieve the same thing:

const x = doItOneWay()

// Alternatively:
const x = doItAnotherWay()

I guess standard would implicitly impose a rule to split such snippets? In this case, to not reassign x.

[feross]

@vweevers Yeah, we'd certainly need to disable some of the rules for examples, like unused variables for example. I think we can look at what standard-markdown disables as a starting point: https://github.com/zeke/standard-markdown/blob/2f044f48eed5f7162147e7927b65a61387200341/lib/linter.js#L8-L15