Ghost Nodes: The Complete Reference

Introduction

This is a self-documenting reference for ox-ghost, the Emacs org-mode export backend that converts .org files to Ghost's Lexical JSON format.

Every section shows:

1. The rendered resultas it appears in Ghost
2. An Org Sourcetoggle below (click to see the org-mode code)

At the end, you can download this very document and its Lexical JSON output.

Text Fundamentals

Paragraphs

The simplest element. Just write text with blank lines between paragraphs.

This is the first paragraph. It can span multiple lines in your org file - they'll be joined.

This is a second paragraph, separated by a blank line.

Text Formatting

Org-mode formatting maps to Lexical's text format bitmask:

Format text with bold, italic, strikethrough, underline, and code.

Combine them: bold-italic, bold-underline, all three.

Links

External link: Ghost CMS

Plain URL auto-links: https://ii.coop

Email: Contact us

Line Breaks

Force line breaks with double backslash.

Line one
Line two
Line three

Headings

Org headlines become Lexical headings. The post title is H1, so content starts at H2.

Lists

Unordered Lists

• First item
• Second item with bold
• Third item with link

Ordered Lists

1. First step
2. Second step
3. Third step

Nested Lists

• Parent item
  • Child item
  • Another child
    • Grandchild
• Back to parent
• Numbered parent
  1. Numbered child
  2. Another child
• Back to parent

Checkbox Lists

• Unchecked task
• Completed task
• In progress

Blockquotes

The best way to predict the future is to invent it. — Alan Kay

Horizontal Rules

Content above.

Content below.

Code Blocks

Code blocks support syntax highlighting via Prism.js.

def hello(name):
    return f"Hello, {name}!"

print(hello("Ghost"))

None

More Languages

// JavaScript
const greet = (name) => `Hello, ${name}!`;
console.log(greet("World"));

Hello, World!
undefined

#!/bin/bash
echo "Hello from $(hostname)"

Hello from nextral.sharing.io

;; Emacs Lisp
(defun greet (name)
  (message "Hello, %s!" name))

greet

Callout Blocks

Callouts highlight important information with color-coded backgrounds.

All Seven Colors

Common Emoji Names

Toggle Blocks

Toggles hide content behind a clickable heading. They support rich HTML content!

Aside Blocks

Asides provide tangential information with distinct styling.

Tangential content here. Supports formatting and links.

Button Blocks

Buttons create prominent call-to-action links.

Header Cards

Full-width banners with text overlay.

Signup Forms

Capture email subscribers.

Regular layout:

Wide layout:

Split layout:

Email-Only Content

Content that only appears in newsletter emails, not on the web post.

Call to Action (CTA)

Prominent sections to drive reader action.

Bookmark Cards

Rich link previews with metadata.

Ghost: The Creator Economy Platform

The world's most popular modern publishing platform for creating a new media platform.

TryGhost/Ghost

Independent technology for modern publishing, memberships, subscriptions and newsletters.

Product Cards

Showcase products with optional buy buttons.

Images

Regular width (default):

Wide width:

Full width:

Video Blocks

Audio Blocks

File Downloads

Gallery Blocks

Embed Blocks

Embed external content (YouTube, Twitter, etc.).

Asciinema Player

Embed terminal recordings with the asciinema player. Perfect for demos, tutorials, and documentation.

Star Wars Demo

The classic ASCII Star Wars animation via telnet:

Star Wars Episode IV (ASCII)

Player Options

Available Themes

With Custom Settings

Local Cast Files

When using local files, they're tracked for upload:

Tables

Tables export as HTML blocks (Lexical lacks native table support).

REPL Blocks

REPL blocks combine code with output in styled presentations.

Simple (default)

2 + 2

4

Labeled

for i in range(3):
    print(f"Item {i}")

Output:

Item 0
Item 1
Item 2

Callout

echo "Build succeeded!"

Toggle

[0, 1, 1, 2, 3, 5, 8, 13]

Aside

Raw HTML

When Lexical nodes aren't enough, embed raw HTML.

Raw Lexical JSON

Insert raw Lexical JSON directly (advanced).

This is useful for nodes ox-ghost doesn't yet support.

The Export Pipeline

Step 1: Write Your Org File

Create your content using the patterns shown above.

Step 2: Export to Lexical JSON

cd /path/to/ox-ghost
./org-to-lexical.sh input.org output.json

Step 3: Validate the Output

node validate-lexical.js output.json
# With HTML preview:
node validate-lexical.js output.json --html preview.html

Step 4: Create Ghost Post

cd /srv/ii.coop
node ghost.js post create "Post Title" output.json --format lexical

Step 5: Upload Media (Optional)

For video/audio/files, upload first then update the org with URLs:

# Upload media file
node ghost.js upload /path/to/video.mp4

# Returns: https://coop.ghost.io/content/media/2026/01/video.mp4
# Add this URL to your :src attribute

Step 6: Enrich Media Metadata

Auto-populate width/height/duration from uploaded files:

;; In Emacs, with ghost-publish.el loaded:
M-x ghost-publish-enrich-buffer

This probes each media URL and adds the metadata attributes.

Membership Paywall

The PAYWALL block marks where free content ends and members-only content begins.

🎉 Secret Members-Only Content

Congratulations! You've unlocked the exclusive members-only section.

Here's what free readers are missing:

• The meaning of life: 42
• The best programming language: the one that pays your bills
• The secret to happiness: good coffee and clean code

Download This Document

This post is self-documenting. Download the source files:

Summary: All Node Types