Introducing mdut

I write a fair bit of Markdown. It powers all the content on this site and it’s all over GitHub and Slack, where I type most things I don’t type in my text editor. In the course of all this Markdown writing, I often find myself wanting to link elsewhere and then generating Markdown URL tags. While they’re not terrible to type out, it’s a bit tedious to have to:

• switch from the editor to the browser,
• go to the relevant web page in a browser,
• copy the URL,
• switch back to the editor,
• paste the URL,
• switch back to the browser,
• view page source,
• find <title> tag,
• copy its contents,
• close the tab,
• switch back to the editor,
• paste the title!

So now I don’t have to!

mdut is a tiny little tool for generating Markdown URL tags from a given URL. It functions as both a standalone CLI tool and Python library.

Here’s what the CLI interaction looks like:

$ mdut https://example.com
Copied to clipboard:
[TODO]: https://example.com "Example Domain"

And here’s how to use it in Python:

>>> import mdut
>>> mdut.reference("https://example.com")
'[TODO]: https://example.com "Example Domain"'

And here’s how I use it from inside Neovim:

nnoremap <Leader>mr :!mdut -s reference 
nnoremap <Leader>mi :!mdut -s inline 
nnoremap <Leader>ms :!mdut -s slack

The sequence Space, m, r drops me on the command row ready to paste the URL and press Enter to execute it, and then I can just paste it!

And that’s pretty much it. You can see more in the repo, and the package is available on PyPI.

Thanks for reading! You can keep up with my writing via the feed or newsletter, or you can get in touch via email or Mastodon.