# Testing Markdown With CI

**URL:** <https://discuss.circleci.com/t/testing-markdown-with-ci/22998>\
**Category:** Tips, Tricks, and Hacks\
**Created:** [June 15, 2018, 8:59pm UTC](https://discuss.circleci.com/t/testing-markdown-with-ci/22998 "2018-06-15T20:59:54Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![FelicianoTech](https://sea2.discourse-cdn.com/circleci/user_avatar/discuss.circleci.com/felicianotech/32/21348_2.png) [@FelicianoTech](https://discuss.circleci.com/u/FelicianoTech)\
**Post date:** [June 15, 2018, 8:59pm UTC](https://discuss.circleci.com/t/testing-markdown-with-ci/22998/1 "2018-06-15T20:59:54Z")

</div>

_TL:DR; I wrote [a blog post](https://circleci.com/blog/markdown-proofer/) on testing Markdown files_

Hey People,

So I run about 10 small websites all built with Hugo. I also work for CircleCI where our marketing website and CircleCI Docs are built with Jekyll. It’s safe to say I spend a lot of time thinking about building and testing static websites. If you look through my past blog posts you’ll see that I have several posts sharing how to build and test Hugo websites and a colleague wrote about deploying static sites.

A lot of static site testing boils down to using [HTML Proofer](https://github.com/gjtorikian/html-proofer), a great tool that tests the generated HTML (in the `public` directory). I wanted to focus more on ways we can add additional tests, for example by testing Markdown files before Hugo even does its thing. So I wrote a blog post.

I wrote a blog post discussing further testing you can do with Markdown files, a tool I made called Markdown Proofer, and how we found and fixed several mistakes in the Markdown for CircleCI Docs, making a better resource for everyone.

If that sounds interesting, you can find the blog post [**here**](https://circleci.com/blog/markdown-proofer/).

---

<div class="post-metadata">

**Author:** ![FelicianoTech](https://sea2.discourse-cdn.com/circleci/user_avatar/discuss.circleci.com/felicianotech/32/21348_2.png) [@FelicianoTech](https://discuss.circleci.com/u/FelicianoTech)\
**Post date:** [August 14, 2018, 8:59pm UTC](https://discuss.circleci.com/t/testing-markdown-with-ci/22998/2 "2018-08-14T20:59:59Z")

</div>

This topic was automatically closed 60 days after the last reply. New replies are no longer allowed.