gitwtfhub

wtf is floralmd?

yingkaisun-kai/floralmd — explained in plain English

Analysis updated 2026-05-18

19SwiftAudience · generalComplexity · 2/5Setup · easy

TL;DR

A native Mac app for opening and editing single Markdown files anywhere on your computer, no vault or folder setup required.

Mindmap

mindmap
  root((FloralMD))
    What it does
      Opens any md file
      Live rendering
      No vault needed
    Tech stack
      Swift
      AppKit
      TextKit 2
    Use cases
      Quick edits
      Floating notes
      Finder preview
    Audience
      Mac users
      Writers
      Note takers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Open and edit a stray Markdown file on your Mac without creating a project folder first.

REASON 2

Keep a floating, always-on-top note window open while working in other apps.

REASON 3

Preview any Markdown file instantly from Finder using Quick Look.

REASON 4

Track which parts of a document changed since the last Git commit while editing.

What's in the stack?

SwiftAppKitTextKit 2swift-markdownSwiftMathSparkle

How it stacks up

yingkaisun-kai/floralmddai-ski/lyralageev/focusmic
Stars191919
LanguageSwiftSwiftSwift
Setup difficultyeasymoderateeasy
Complexity2/52/52/5
Audiencegeneralgeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Prebuilt DMG installs are quick, building from source needs macOS 14+ and Xcode.

License details are not stated clearly in the README.

Wtf does this do

FloralMD is a Markdown editor built for Mac computers. Its main idea is simple: you should be able to open a single Markdown file from anywhere on your computer and start reading or editing it right away, without first creating a folder or a special workspace for it. Tools like Obsidian ask you to set up a vault before you can work, and FloralMD skips that step entirely. When you open a file, FloralMD renders the Markdown as you type, similar to how Typora or Obsidian look, so you see formatted text instead of raw symbols. You can keep several files from different folders open together as tabs in one window, and a sidebar helps you find nearby or already open documents. There is also an outline view that summarizes the current document using its headings, lists, and code blocks, plus markers showing where the file has changed compared to its last saved Git version. A few extra features stand out. It integrates with Finder's Quick Look, so pressing the space bar on a Markdown file shows a proper rendered preview instead of plain text. It also supports floating notes, meaning a document window can stay on top of other apps with a see-through background, useful for jotting quick notes while working elsewhere. FloralMD is built using Swift, AppKit, and TextKit 2, meaning it is a native Mac application rather than one built with Electron, and it works offline by default while blocking unsafe external content unless you allow it. Installation is done by downloading a DMG file from the project's GitHub releases page and dragging the app into the Applications folder. Because the app is not yet signed with an Apple Developer ID or notarized, macOS may warn about an unverified developer, and the README explains how to allow it manually through system settings. Building from source requires macOS 14 or later and Xcode, and relies on a handful of external libraries for Markdown parsing, math rendering, and update checking.

Yoink these prompts

Prompt 1
Explain how to install FloralMD from a GitHub release DMG on my Mac.
Prompt 2
Walk me through building FloralMD from source using Swift and Xcode.
Prompt 3
What's the difference between FloralMD and Obsidian for editing a single Markdown file?
Prompt 4
Show me how to enable Finder Quick Look support when building FloralMD locally.
Prompt 5
Summarize FloralMD's floating notes feature and how Quick Capture works.

Frequently asked questions

wtf is floralmd?

A native Mac app for opening and editing single Markdown files anywhere on your computer, no vault or folder setup required.

What language is floralmd written in?

Mainly Swift. The stack also includes Swift, AppKit, TextKit 2.

What license does floralmd use?

License details are not stated clearly in the README.

How hard is floralmd to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is floralmd for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.