medium-import

NodeJS cli-tool to import drafts to your Medium.com account

Usage no npm install needed!

<script type="module">
  import mediumImport from 'https://cdn.skypack.dev/medium-import';
</script>

README

medium-import

Easy way to import article drafts to your Medium.com account via commandline! This is very useful if you want to import Markdown formatted drafts more easily.

(Although Medium does support importing Markdown via web-interface, we found out that this is very tedious and error-prone to do).

Prerequesites

  • Requires NodeJS v4 or higher

Install

npm install -g medium-import

How to use

Before usage, you need to create application access tokens (clientId, clientSecret) and an integration token in your Medium account settings. To prevent retyping this information in the cli, just add following JSON config in your $HOME/.medium-import-rc:

{
    "clientId": "CLIENT-ID",
    "clientSecret": "CLIENT-SECRET",
    "integrationToken": "INTEGRATION-TOKEN",
    "format": "md"
}

Commandline:

Usage: medium-import [options] <file> <title>

Options:

-h, --help                          output usage information
-ci, --clientId <clientId>          The registered application clientId
-cs, --clientSecret <clientSecret>  The registered application clientSecret
-it, --integrationToken <token>     The registered integration token
-f, --format <md|html>              File content format (markdown / html)

The flags -ci, -cs, -it, -f will override preconfigured parameters in $HOME/.medium-import-rc.