Pliny

Note: Pliny is currently in alpha. Expect breaking changes.

Pliny makes creating, editing and publishing markdown content easy and simple. It is based on Next.js, Tailwind CSS and Contentlayer.

Installation

npm i -g @pliny/cli

Usage

Here are some examples of common commands:

Create a new starter blog project called "my-blog"

pliny new --template=starter-blog my-blog

Add a recipe

Currently, there are 2 main types of recipes - scaffolding a content type e.g. the pages associated with a blog or adding templates to the layouts folder. As a convention, recipes to scaffold are in the form of add-[content type] while layouts are in the form of [content type]-[theme].

Adding a blog page to an existing Next.js application (assumes you have contentlayer setup, as it will automatically add defineDocumentType)

pliny install add-blog ContentDir=data ContentName=Blog

Add the blog-classic templates to the layouts folder:

pliny install blog-classic

Features

Content Modeling with Contentlayer

• Live reload on content changes
• Fast and incremental builds
• Simple but powerful schema DSL to design your content model (validates your content and generates types)
• Auto-generated TypeScript types based on your content model (e.g. frontmatter or CMS schema)

Templates

• Based on Next.js and Tailwindcss
• Highly configurable config, easily extendable nextjs website
• Mobile friendly
• Supports light and dark theme
• Layouts to customize templates
• Blog theme is completed, docs is in the works

Full suite of markdown plugins

• Server-side syntax highlighting with line numbers and line highlighting via rehype-prism-plus
• Math display supported via KaTeX
• Citation and bibliography support via rehype-citation

Modular React components for services

• Newsletter (Buttondown, Convertkit, Email Octopus, Klaviyo, Mailchimp, Revue)
• Analytics (Google Analytics, Plausible Analytics, Simple Analytics, Umami Analytics, Posthog)
• Comments (Disqus, Giscus, Utterances)
• Search (Algolia, Kbar local search)