I've written my first man page! https://github.com/Wilfred/difftastic/commit/cb63ca88303d3c8dffd763cf6e5772e45c045588
Troff syntax is new to me and a little hard to read -- apparently you shouldn't use blank lines. Turns out you can use pandoc to convert markdown to troff instead.
miniblog.
Related Posts
6
Terminad is a really interesting approach to rendering markdown in the CLI. It deliberately doesn't render links, so you can always see both the link text and the URL.
In a browser you have hover to see URLs, but not necessarily in a terminal.
31
One cute feature of markdown I'd not noticed before: there's no syntax for images *without* a description (i.e. alt text).
22
Today I learnt that you can mix HTML inline in markdown! For example, the following is valid.
Foo <hr/>
I'd assumed that you needed HTML separately, like ``` blocks, but no: https://spec.commonmark.org/0.31.2/#raw-html
Admittedly HTML is very restricted on most sites, but it's helpful for SSGs.