https://github.com/lmammino/ghost2hexo

A command line tool to convert Ghost json export to a set of source posts for Hexo
https://github.com/lmammino/ghost2hexo

blog blogging conversion conversions ghost hexo import importer migration

Last synced: 12 months ago
JSON representation

A command line tool to convert Ghost json export to a set of source posts for Hexo

• Host: GitHub
• URL: https://github.com/lmammino/ghost2hexo
• Owner: lmammino
• License: mit
• Created: 2016-07-15T20:45:26.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2019-01-22T03:20:22.000Z (over 7 years ago)
• Last Synced: 2025-05-09T00:57:16.953Z (about 1 year ago)
• Topics: blog, blogging, conversion, conversions, ghost, hexo, import, importer, migration
• Language: JavaScript
• Homepage: https://lmammino.github.io/ghost2hexo/
• Size: 54.7 KB
• Stars: 6
• Watchers: 2
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# ghost2hexo

A quick'n'dirty command line tool written in Node.js to convert

[Ghost](https://ghost.org) JSON exported posts into a set of source posts for

[Hexo](https://hexo.io)... Long story short, an helper to migrate from Ghost to

Hexo (and probably other static website publishing platforms).

[![npm version](https://badge.fury.io/js/ghost2hexo.svg)](https://badge.fury.io/js/ghost2hexo)

[![CircleCI](https://circleci.com/gh/lmammino/ghost2hexo.svg?style=shield)](https://circleci.com/gh/lmammino/ghost2hexo)

[![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)

## Install

With Node.js and Npm installed, as easy as:

```bash

npm install -g ghost2hexo

```

## Usage

From your terminal of choice:

```bash

ghost2hexo ghost_data.json path/to/hexo/source/_posts

```

Where:

  - `ghost_data.json`: is the file exported from the Ghost admin

  - `path/to/hexo/source/_posts`: the posts folder of your local Hexo project

## Quick migration guide

1. Prepare your Hexo environment (you can follow the official [quick start](https://hexo.io/docs))

2. Login into your Ghost admin

3. Go to Settings > Labs and click the blue "Export" button (this will download

  the ghost data JSON file)

4. Download your images and files from the `contents/images` folder of your ghost installation

5. Use the `ghost2hexo` command to generate the posts for Hexo

6. Copy your Ghost images into the your Hexo `sources/contents/images`

7. Regenerate your static website with `hexo generate`

## Contribute

Feel more than welcome to

[report bugs](https://github.com/lmammino/ghost2hexo/issues) or [propose changes](https://github.com/lmammino/ghost2hexo/pulls).

## License

Licensed under [MIT](https://github.com/lmammino/ghost2hexo/blob/master/LICENSE).