Repolode
flowershow

flowershow/flowershow

Publishes Markdown folders, notes and docs as websites in seconds, with drag-and-drop, Obsidian, GitHub and a CLI for AI agents.

Open-source alternative to:NotionGitBook

Stars
1,111
Forks
120
Open issues
88
Last commit
3 days ago

What is it?

Flowershow is a publishing platform for turning Markdown files into websites for documentation, knowledge bases, wikis and digital gardens. Users can publish by dragging files into the web app, through an Obsidian plugin, from a GitHub repository, or with the `fl` command-line tool.

The `fl` CLI is a single Go binary that publishes a folder or file with `fl login` and `fl ./my-notes`. It is also intended as the interface for AI agents such as Claude, ChatGPT, Codex and Cursor to publish content. The web app is built with Next.js and TypeScript, and the monorepo includes a REST API contract with an OpenAPI 3.1 spec, a Cloudflare worker for Markdown processing, and a remark plugin for wiki-style links.

The project is licensed under AGPL-3.0 and is developed by Datopian. Running it from source requires Node.js 22+, pnpm and Docker, and the local stack includes Postgres, MinIO and Inngest.

Key features

  • 01Publish Markdown by drag and drop, from Obsidian, or from GitHub
  • 02Single `fl` CLI binary for macOS, Linux and Windows
  • 03Wiki-style links supported via a remark plugin
  • 04REST API with OpenAPI 3.1 spec and interactive Swagger docs
  • 05Built on Next.js with Tailwind CSS

Use cases

  • Publishing an Obsidian vault as a public digital garden
  • Hosting project documentation or a knowledge base from Markdown files
  • Letting an AI agent publish notes or docs to a website via the CLI

Quick start

  1. 1

    Install the fl CLI on macOS or Linux using the official install script from the README

  2. 2

    Log in to your Flowershow account

    fl login
  3. 3

    Publish a folder or file

    fl ./my-notes

Things to know

  • Licensed under AGPL-3.0, a copyleft license that requires derivative network services to share their source code.
  • Publishing requires a Flowershow account, and the README's Windows CLI install is a manual zip download.

In collections

Topics

FAQ

What is flowershow?
Publishes Markdown folders, notes and docs as websites in seconds, with drag-and-drop, Obsidian, GitHub and a CLI for AI agents. Flowershow is a publishing platform for turning Markdown files into websites for documentation, knowledge bases, wikis and digital gardens. Users can publish by dragging files into the web app, through an Obsidian plugin, from a GitHub repository, or with the `fl` command-line tool.
Is flowershow free to use? What license does it have?
flowershow is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is flowershow still maintained?
Actively maintained. The last commit to flowershow was on Nov 3, 2026.
What can I use flowershow for?
Publishing an Obsidian vault as a public digital garden Hosting project documentation or a knowledge base from Markdown files Letting an AI agent publish notes or docs to a website via the CLI
How do I install flowershow?
Install the fl CLI on macOS or Linux using the official install script from the README Log in to your Flowershow account: fl login Publish a folder or file: fl ./my-notes
Where can I get flowershow?
The source code and installation instructions are on GitHub: https://github.com/flowershow/flowershow

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects