💻

Markdown in excerpts

HTML code not showing up in excerpts.

Problem

Sensitive to newly discovered accessibility issues in my writing I am now using … and — all over the place because I don't think I can change my writing style to avoid them.

I noticed the excerpt in the blog summary that appears on the homepage just renders the markdown.

Solution

I've not implemented this solution yet, but it looks so straightforward that I'm confident it'll work fine: pass the excerpt through a md filter when the component is being called.

Really this post is just an excuse to start writing up these little changes. For this particular one the code will probably be self-documenting to an extent, and at mosta comment in the config file would cover it, but I have a backlog item about pagination that I think I'll want to record my thought process for.

One of the valuable things about building your own project — even something as boring as a blog — is that there are no external requirements. If I was asked to introduce pagination to something in my day job, I'd just have to get on with it; I'd never need to dig into the motivations, justifications or options available to address the problem.

In my own blog what starts as a vague sense that I should be paginating a list of posts quickly becomes a meaningful investigation into what the feature's purpose is, what problem it's expected to solve, what contexts it might work it, etc.

At some point I'll need to extract the above out into a separate post, but it's fine here for now.

Result

As expected, worked great.

END