Assuming that [this](https://github.com/github/docs/blob/main/content/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions.md) is the file in question, you're not using a standard flavor of Markdown -- it looks like you're making significant use of Liquid-like template tags along with mixing nested Markdown inside raw HTML.

[Mohdshoib12]

Assuming that this is the file in question, you're not using a standard flavor of Markdown -- it looks like you're making significant use of Liquid-like template tags along with mixing nested Markdown inside raw HTML.

This means that, as you've seen, there's no guarantee that Vale will be able to correctly parse and lint your content (GitHub itself, as you can see in the file preview I linked above, cannot render it correctly).

It's possible to work around these issues by using a combination of BlockIgnores and TokenIgnores, but it's not necessarily straightforward.

Another option would be to run Vale on your site's generated HTML, which should just work as you'd expect.

Originally posted by @jdkato in #387 (comment)