r/Markdown

(Open Source) I built a second brain app where AI agents help you think — but you review every change before it happens
▲ 319 r/Markdown+4 crossposts

(Open Source) I built a second brain app where AI agents help you think — but you review every change before it happens

Most second brain apps stop at storage. You capture a note, tag it, link it, and hope you find it again someday. NeverWrite is built around the idea that your second brain should actually help you think, not just hold your thoughts. It's a local-first desktop app for macOS and Windows where your notes are plain Markdown files on your machine. No cloud sync, no account required, no telemetry. Your vault is yours.

The part I'm most excited about is the AI layer. NeverWrite supports agents powered by Claude, Codex, Gemini and Kilo, that work directly inside your vault. You can ask an agent to help you synthesize notes on a topic, find connections you missed, or draft a new note from your existing material. The key thing is that agents propose edits and you review them before anything changes, it has inline review hunks like modern code editors. The AI helps you process and connect your knowledge; it never rewrites your vault behind your back. That felt like the only honest way to build this.

If you've been frustrated by second brain tools that are great at capture but useless at synthesis, or by AI tools that feel like a black box you can't trust, NeverWrite is trying to solve both at once. Happy to answer any questions about how the agent review flow works or anything else.

Also, is open source ;)

https://neverwrite.app/

https://github.com/jsgrrchg/NeverWrite

Have fun with your vaults!

u/jsgrrchg — 3 days ago
▲ 27 r/Markdown+14 crossposts

Ask questions across your Markdown notes using a fully local Graph RAG engine. Built for Obsidian vaults, works with any folder of Markdown files. Extracts entity-relation triples from wikilinks & YAML frontmatter, retrieves answers via hybrid search (vector + BM25 + temporal). Multilingual. No cloud. Runs on Ollama.

https://github.com/benmaster82/Kwipu

u/WritHerAI — 2 days ago
▲ 509 r/Markdown+2 crossposts

[MAC] Editorio — native macOS markdown + code editor, free forever

Dev here, 20 years in. Built Editorio for myself a while back because nothing on the mac did everything I wanted in one place. It's polished enough now that I figured I'd share it.

Subscription text editor. Subscription notes app. Subscription markdown previewer. (lol). We live in the future. Macs have neural engines, and the industry's answer to "I want a nice text editor" is 4.99/month to render # heading as bold text. Cool.

Problem

Most Mac markdown editors are either Electron bloatware (500MB+ RAM, slow cold start) or behind a subscription / one-time fee just to render basic markdown. And most code editors don't do markdown preview well. I wanted one fast native app that handles both: markdown writing AND code files, without paying rent on a monospace font.

Comparison

  • vs Typora: Typora is 14.99 USD one-time and not native AppKit. Editorio is free and native, opens files in under 100ms.
  • vs iA Writer: iA Writer is ~50 USD and writing-focused. Editorio also handles 180+ programming languages with syntax highlighting, so it doubles as a code editor.
  • vs VS Code: VS Code is Electron, ~500MB RAM, slow cold start. You don't need a full IDE just to open a markdown file or peek at some code. Editorio is ~40MB RAM, native AppKit, instant launch.
  • vs Sublime Text: Sublime is 99 USD per license and still doesn't do real markdown preview out of the box. Editorio is free and ships with live markdown preview built in.

Pricing

Free. Forever. No nag, no asterisk, no "free for personal use only".

https://apps.apple.com/app/editorio/id6759334075

What's in it:

  • Markdown editor with live preview
  • Code editor with syntax highlighting (swift, py, ts, rust, etc.)
  • Mac native, AppKit. No Electron, no web views
  • Light/dark themes, minimap, tabs
  • ~40MB RAM, lightning fast

Me posting to reddit is the entire marketing budget. Already gave Apple my 100 bucks for the dev account, so if you actually like it, send it to a friend or drop it in a Slack somewhere.

Planning to open source it on github too once I clean up the repo.

Long live free apps instead of charging rent on a monospace font.

Edit: since so many of you keep insisting... yes, fine, you can buy me a coffee. I'm genuinely a little embarrassed about it, but here we are.

u/VanLocke — 4 days ago

An editor that has 'refresh' either auto or manual?

For example, I'm writing up a .md file (in ai or etc). I want to view the rendered md, so I open it in an md editor/reader. But, now we change the md, in other app, and I want to view the current md. I have to close and reopen the md file. That's boring. What I want is to be able to F5 and get a fresh copy in my md editor. Or, what would be neat is to have it monitor the file for outside changes.

reddit.com
u/Derrmanson — 4 days ago

Markdown is 20 years old. It was never meant for AI. Until now.

MarkdownAI adds one line to the top of any .md file and makes it live.

MarkdownAI Directives

All directives available in MarkdownAI, organized by category.

Document Structure

Directive Purpose
u/markdownai Document header - activates the MarkdownAI runtime
u/include Inline file content at the directive site
u/import Import definitions (macros, connections) without rendering content
u/define / u/end Declare a named macro
u/call Invoke a macro
u/phase / u/end Declare a workflow phase
u/if / u/end Conditional block
u/section Named section boundary
u/chunk-boundary Explicit chunk split point for rendering

Variables & Environment

Directive Purpose
u/env Resolve an environment variable

Data Sources

Directive Purpose
u/connect Register a named data source connection
u/db Execute a database query
u/http Fetch from an HTTP endpoint
u/query Query a registered data source
u/read Read raw file content
u/list List directory contents
u/tree Directory tree output
u/date Current date/time
u/count Count items in a source

Processing & Output

Directive Purpose
u/pipe Chain output through transformations
u/render Render output in a specific format
u/graph Generate a visualization
u/header Document-level metadata header

Annotations & Constraints

Directive Purpose
u/constraint Machine-readable rule or constraint
u/define-concept Vocabulary alignment - bind a term to a precise definition
u/prompt Embedded instruction for the AI reading the document
u/note Human-readable annotation (not rendered in AI format)

Caching

Directive Purpose
u/cache Cache directive output (option on data source directives)

Phase Events

Directive Purpose
u/on complete -> Declare what executes when a phase finishes (only valid inside u/phase blocks)

What is MarkdownAI? There seems to be a lot of confusion.

Most people assume MarkdownAI works like this:

Claude reads a rendered MarkdownAI file and acts on it.

That's not what happens.

Yes, MarkdownAI can parse and render a .md file into a result - and that's perfectly useful if you're using it as a CLI tool. But that's not why it's called MarkdownAI.

The reason it's called MarkdownAI - and where the real power comes from - is the MCP server, the hooks, and the phase design.

Here's what actually happens:

Claude requests a .md file. The MarkdownAI MCP server intercepts that request. Instead of dumping the whole rendered file into context, it reads the document, identifies the current phase, and hands Claude only what it needs for that phase - exactly like a human would prompt it.

Claude never sees the whole document. It only gets the current phase plus its constraints. This means Claude is always aligned - it only knows what it should know, and it's always working within the boundaries defined for that phase.

This means:

  • Massive token savings - Claude isn't processing 890 pages of documentation on every request
  • No stale context - each phase is executed fresh with live data
  • No hallucination about what exists - the runtime tells Claude exactly what's there
  • Always aligned - constraints are delivered with every phase, not assumed

The power isn't the markdown format. The power is the MCP server turning a document into a live, phase-aware, always-aligned conversation between Claude and your codebase.

That's MarkdownAI.

GitHub: https://github.com/TheDecipherist/markdownai

npm: https://www.npmjs.com/package/@markdownai/markdownai

MarkdownAI - GitHub

u/TheDecipherist — 4 days ago
▲ 1 r/Markdown+1 crossposts

Web Markdown Editor for ReadMEs!!

Hi yall!! Just wanted to share a project I've been working on :)

One of the biggest pain points in project documentation is making a README look professional without spending forever tweaking markdown. I wanted to make that process faster, smoother, and a lot more enjoyable.

With Web README Maker, you can:
• edit markdown in real time with live preview
• generate repository, profile, and custom badges
• use GitHub repo URL detection for quick setup
• customize colors and themes to match your project

Built with Next.js, React, TypeScript, and Tailwind CSS.

Would love any feedback, stars, PRs, feature ideas, or suggestions for what I should add next.

github.com
u/Joe-Codes — 4 days ago

Why I am seeing everyday someone making markdown editor?

What is driving markdown so crazy? Everyday I see someone posting here. What is so interesting about it. I am planning to end this war. Any light how to do it? I have some idea and I am open to make one that has everything and free of cost, no login, no singup, no download everything works for free. Tell me what it will need.

reddit.com
u/Bubbly-Newt5118 — 6 days ago
▲ 19 r/Markdown+1 crossposts

NotepadMD 1.5 - Links and Table of Contents (plus scroll position whack-a-mole)

It's been a bit of a long time coming, but I finally managed to get version 1.5 out with better support for cross document links and support for table of contents. Use of [TOC] as a tag in markdown will produce an auto generated, auto-updating table of contents. If you have other table of contents tag formats, we support every tag format we could find. Oh, and our word export creates an actual word table of contents for that, not just a list of links.

Cross document links was a bit of a hard subject - Obsidian style links are standard, so we support those. GFM slugs are different but "more correct" so we support those as well. Those are both a bit fragile though - if someone comes along and changes a heading name in a document you've linked to then your link gets broken, so we also support ID based heading links. That does need you to write the id to the end of the heading, which possibly involves updating the other file to add a heading, but it's worth it to keep references stable in codebase documentation. You can pick the model you prefer.

Outside of that, the back and forward navigation needed to get smarter and take you to the right scroll position in the target document. That was a pig as there's a lot at play with document dynamic loading, but hopefully you'll find it's all working pretty smoothly now.

The usual general quality of life updates too - users reported loss of selection highlight so that's fixed along with some other issues and bug fixes. All in the release notes. Starting to get close to where I envisioned the "base" functionality being!

u/NamelessParanoia — 7 days ago

Markdown vs HTML

Hi guys, I'm the dev behind neverwrite.app There's a new trend going on, people starting to prompt HTML documents instead of Markdown. Insane, right?

Here are my thoughts:

- Token economics matter. Generating HTML is more expensive.

- The training distribution favors Markdown by a huge margin. Models are trained on MD, they actually write to you in the chat in Markdown!!

- Markdown needs a good editor and parser. HTML renders the same every time, but if you want to edit it by hand, it's a painful experience.

- Portability is real value. Markdown docs open cleanly in a lot of editors, for html you are stuck with the browser.

- Rich formatting like diagrams, interactive docs and others is the only good use case for HTML in my opinion.

So when to use HTML? In my case, I'm a sucker for dashboards, Opus does a great job at this. NeverWrite now supports html out of the box 😄. For example here's this article in markdown and html

https://preview.redd.it/p31i1d6crv0h1.png?width=1971&format=png&auto=webp&s=614454e12db829b4575195c9e47e82eef2e1effa

You don't have to choose anymore, have fun! And happy to hear your thoughts in this topic.

Neverwrite.app, your agentic, open source, markdown workspace.

Note: Written by a human.

reddit.com
u/jsgrrchg — 9 days ago

Is there a Markdown editor that can finally replace LaTeX for thesis writing?

Markdown editors seem to be popping up everywhere lately — but most of them are just note-taking tools with a PDF button that produces something ugly.

Has anyone found one that actually handles the full thesis workflow? I'm talking: proper title page, auto-generated TOC, citations with a real bibliography (not manual formatting), KaTeX math, footnotes at the page bottom, and a print-ready PDF that doesn't look like it came from a browser.

Bonus points if it runs in the browser without a local LaTeX install, because I'm tired of debugging TeX Live errors at 2am.

reddit.com
u/ExpensiveBill9880 — 11 days ago
▲ 3 r/Markdown+2 crossposts

Markdown sharing solutions

I use agents on two VPS and have few humans who work on same markdown. We use markdown for most of documents, some CSVs and considering HTMLs.

Biggest challenge is how do you share across agents and humans, especially external collaborators.

My current setup includes:
- Obsidian sync between humans
- Push to Github as cron jobs
- agents pull the github repos
- copy paste to Gist or HackMD to share externally

what i want is:

  1. agents making changes to docs with diffs (only human approve)
  2. sharing files, not entire repository, with a specific external collaborator
  3. folder level access control on repo for agents. like an agent can only see folder A and edit folder B inside it.

markdowns and html are cool till we need to rebuild entire stack

reddit.com
u/Busy_Amoeba8586 — 8 days ago
▲ 0 r/Markdown+1 crossposts

Built an opensource WYSIWYG markdown editor for desktop — tired of fighting raw syntax while writing agent prompts/docs

I noticed that there's a lot of markdown dependency for working with AI agents/conversational interfaces. I'm not a markdown expert... and couldn't help but feeling like opening these files in VSCode is overkill, then only to have to download an extension to be able to view them in editor.

I built a small open-source desktop app — Lumina — that treats markdown like a word processor. You format type as bold, you see bold. You type as a header, you see a header.

Works for both macOS and Windows. Completely local, no accounts, no cloud.

Repo + installers: github.com/micahman33/lumina

Happy to hear what's missing if anyone tries it.

reddit.com
u/The_I_in_TEIAM — 11 days ago

markdown layouten

hallo zusammen, neuerdings spriessen ja markdown editoren wie pilze aus dem boden ... hat schon jemd einen gefunden mit dem ich LaTeX endlich in die Ecke stellen kann?

reddit.com
u/ExpensiveBill9880 — 11 days ago