Skip to content

ghost-md-publisher · Markdown publisher for Ghost

Open sourcePublishing

From Markdown to Ghost in one command

Write in Markdown, in your own editor and under version control if you like, and publish without opening a browser. It uploads and optimises the images and creates the post as a draft through Ghost's Admin API.

bash — ~/articulos

From a Markdown file to a Ghost draft, images and all

ghost-publish article.md

▶ Reading: article.md

· title: How to publish to Ghost from Markdown

· status: draft · tags: Example, Tutorials

▶ Local images detected: 2

▶ Processing and uploading images…

· encabezado.jpg → …/images/2026/10/encabezado.7f54532cc4.jpeg

· interior_1.jpg → …/images/2026/10/interior_1.21a17b0612.jpeg

▶ Rendering Markdown to HTML…

▶ Creating/updating post (status=draft)…

✓ Done.

· URL: https://example.com/p/f97b38b7-268c-414d-b864-8c252debf535/

It stays a draft; images come optimised with EXIF stripped

How it lands in your Ghost

Draft

Cómo publicar en Ghost desde Markdown

  • Ejemplo
  • Tutoriales
  • 2 images uploaded, optimised and with no EXIF
  • The Markdown, turned into HTML for Ghost
ghost-md-publisher: from a .md to a Ghost draft with one command

How it works

  1. You write in Markdown

    In your own editor, with version control if you like.

  2. You do a dry run

    It shows what it would send to Ghost without sending anything.

  3. You publish as a draft

    It turns the images into WebP, builds the native cards and leaves the post as a draft.

Who it is for

  • Ghost writers and editors
  • Newsrooms that write in Markdown
  • Xpresiva sites
  • Developers

What it does

Publish to Ghost from a .md file, with processed images and native cards.

  • Runs onNode.js
  • 7 languagesEnglish · Spanish · French · German · Portuguese · Italian · Dutch
  • LicenceMIT
  1. Images ready to go

    Resizes them and converts them to WebP with sharp before upload, with a cache.

  2. Native cards

    Video, bookmark, callout, image caption and product card.

  3. No duplicates

    If the slug already exists, it stops and only updates the post when you ask.

  4. Dry run

    Shows what it would send to Ghost without sending anything.

  • 7

    languages

  • 5

    native card types

Open source

Get started

Install
npm install -g @oksigenia/ghost-md-publisher
Then publish a folder with its .md and images
ghost-publish ./my-article/

Licence · MIT

You can use, change and build it into any project, closed or commercial included, keeping the copyright notice.

Latest release

0.3.3 · 21 Aug 2026

Standard

  • Drafts by default
  • Ghost limits checked before sending
  • Open source (MIT)

Pricing

Free · open source

Licence: MIT

Markdown publisher for Ghost

ghost-md-publisher

Publish to Ghost from a .md file, with processed images and native cards.