An automated workflow for scientific writing on Medium

How to upload Markdown files to Medium while maintaining tables, syntax highlighting, math typesetting, and footnotes.

Joseph Kato
6 min readOct 24, 2021


Image by

Medium is an excellent platform for blogging and it has increasingly become a go-to source of knowledge on data science and other technical topics.

Unfortunately, though, the writing experience on Medium for scientific topics isn’t great: there’s no support for tables, code syntax highlighting, math typesetting, or footnotes — all pretty essential elements for many posts.

I’m not the first person to run into this issue, either. A few searches for keyword phrases like “medium math formula” demonstrate how widespread the issue really is:

While these are all useful articles in their own right, none of the proposed solutions were particularly appealing to me.

What if I want to write a typical Markdown post once and have it “just work” on Medium?

Well, now you can.

Introducing pb, an open-source CLI tool

pb is an open-source, command-line tool designed to facilitate a multi-platform, scientific publishing workflow.

The idea is pretty simple: you write your post locally using your favorite Markdown editor, such as VS Code or Typora, and then use pb to upload it to…



Joseph Kato

An open-source software developer with interests in natural language processing, data science, and collaborative writing. More @