markdown-to-medium
Publish markdown to Medium. Extracted from @jxnblk's script (thank him if you see him).
Getting Started
- Get a third party integration token on medium
- Install
markdown-to-medium
- Copy the token to the clipboard
- Create an article with the token passed through
--token
- The token is now stored locally for future use, rinse repeat
Usage
Usage: markdown-to-medium <path to markdown>
Options:
-h, --help Output usage information
-v, --version Output version number
-t, --token Pass in the user token, stored after first use
-i, --id Pass in the user id
-u, --canonicalUrl Add a cross-reference to the original url for post
-l, --license Pass in the license
--title Pass in the title
--tags Pass in tags
--publication Publish to a Medium publication
Examples:
$ markdown-to-medium ./foobar.md
# Publish markdown to medium
$ markdown-to-medium ./foobar.md --tags="tag1,tag2" --title="Hello world"
# Publish markdown to medium
Docs: https://github.com/yoshuawuyts/markdown-to-medium
Bugs: https://github.com/yoshuawuyts/markdown-to-medium/issues
License
You can specify a license for your draft. It must be one of these options:
all-rights-reserved
, cc-40-by
, cc-40-by-nd
, cc-40-by-sa
, cc-40-by-nc
,
cc-40-by-nc-nd
, cc-40-by-nc-sa
, cc-40-zero
, public-domain
.
Metadata
To get the correct title and date to show up without using options, you can
use YAML
frontmatter in your markdown:
---
title: 'How to light a tire fire'
created: '6-20-2016'
publication: 'Intention and Integrity'
canonicalUrl: 'https://example.com/how-to-light-a-tire-fire'
tags: ['fire', 'tires']
license: 'public-domain'
---
Now put some of the best words here.
You can do it, you're witty and smart and charming and
Note that created
is not passed through to Medium.
If there is no YAML
frontmatter, you can also specify the title using a first
level markdown header, such as # Title
, on the first line of the file.
Installation
$ npm install --global markdown-to-medium