6 min readNov 12, 2025
–
Press enter or click to view image in full size
Lets check how to use Vale to improve our writing!
Vale offers open source, command line linting for text. It can enforce a specific editorial style guidelines across your content. You can even create your own style or configure and fine-tune another. You can set it up to check Markdown files, AsciiDoc, reStructuredText, HTML, XML and others. Once you have the rules on your machine configured it can also run offline. Last but not least it has many integrations, GitHub Actions among them, which we will later explore and test.
What we will do
We will configure Vale to run both locally and on a GitHub Actions workflow. This will allow us to not forget to fix any issue that it raises. It enables consist…
6 min readNov 12, 2025
–
Press enter or click to view image in full size
Lets check how to use Vale to improve our writing!
Vale offers open source, command line linting for text. It can enforce a specific editorial style guidelines across your content. You can even create your own style or configure and fine-tune another. You can set it up to check Markdown files, AsciiDoc, reStructuredText, HTML, XML and others. Once you have the rules on your machine configured it can also run offline. Last but not least it has many integrations, GitHub Actions among them, which we will later explore and test.
What we will do
We will configure Vale to run both locally and on a GitHub Actions workflow. This will allow us to not forget to fix any issue that it raises. It enables consistent writing across the whole repository. For example, you can do this for enforcing a particular styling in a news website. Potentially use it in a blog site such as the one you read this article on.
What you will end up with
By the end of this guide you will:
- Have Vale linting Markdown locally
- Have a GitHub Actions job configured
- Know how to silence false positives
- Create a custom rule that enforces…