CLIngON allows you to scaffold frontmatter and/or other metadata into your mdx or markdown files.
Last updated a year ago by rajinwonderland .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install clingon-cli 
SYNC missed versions from official npm registry.

CLIngON allows you to scaffold frontmatter and/or other metadata into your mdx files.

oclif Version Downloads/week License



$ npm install -g clingon-cli
$ clingon COMMAND
running command...
$ clingon (-v|--version|version)
clingon-cli/0.0.8 darwin-x64 node-v10.13.0
$ clingon --help [COMMAND]
  $ clingon COMMAND


clingon convert

Convert a medium url into plain old markdown ????

  $ clingon convert

  -h, --help           show CLI help

  -o, --output=output  The desired destination for the parsed markdown (e.g. path/to/content/index.mdx) or copy to copy
                       the markdown

See code: src/commands/convert.ts

clingon create

Scaffold metadata or frontmatter for your mdx or md content

  $ clingon create

  -h, --help           show CLI help
  -o, --output=output  The desired output file for the scaffolded metadata

  $ clingon create
  clingon create -p=/path/to/content
  clingon create -e=mdx

See code: src/commands/create.ts

clingon help [COMMAND]

display help for clingon

  $ clingon help [COMMAND]

  COMMAND  command to show help for

  --all  see all commands in CLI

See code: @oclif/plugin-help

clingon list

describe the command here

  $ clingon list

  -h, --help  show CLI help

See code: src/commands/list.ts

Example Output

For now, the CLIngON cli generates the following frontmatter output which is consistent to what we use over at novvum for our blog which is using gatsbyjs and mdx

export const frontmatter = {
  title: 'TITLE'
  date: '2019-05-14T10:00:00.200Z', // In ISO format
  author: "author's name"
  bio: 'some bio here...'
  twitter: 'twittter-handle',
  github: 'github-handle',
  piclink: 'avatar-link', // Url the author's avatar
  banner: 'image-link', // Url to a banner image
  layout: 'default', // Different keys for generating alternative blog layoutts
  tags: ['tag'] // Tags relevant to the article


Here's the typescript interface it's using

export type FrontMatterOptions = {
  title: string;
  date: Date; // In ISO format
  author: string;
  bio: string;
  twitter?: string;
  github?: string;
  piclink: string;
  banner: string;
  layout: LayoutOptions;
  tags: string[];

export enum LayoutOptions {

The clingon create blog command also will take the title you input and automatically slug it like so

Input Context Slug File
title: "My Article Title" File with the same name does not exist my-article-title path/to/content/my-article-title/index.mdx
title: "I am Ironman" File with the same name exists i-am-ironman-cjvpxcrh8000001msf9pfeayq path/to/content/i-am-ironman-cjvpxcrh8000001msf9pfeayq/index.mdx

Note if a file path with the same directory already exists, a new directory will be created with a collision-resistant id (cuid) hashed at the end to avoid any overwriting issues.

Current Tags

  • 0.0.8                                ...           latest (a year ago)

8 Versions

  • 0.0.8                                ...           a year ago
  • 0.0.7                                ...           a year ago
  • 0.0.6                                ...           a year ago
  • 0.0.5                                ...           a year ago
  • 0.0.4                                ...           a year ago
  • 0.0.3                                ...           a year ago
  • 0.0.2                                ...           a year ago
  • 0.0.1                                ...           a year ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (14)
Dev Dependencies (13)
Dependents (0)

Copyright 2014 - 2016 © |