Your repo should be the source of truth, not the platform
Here is a principle I keep coming back to: the canonical version of everything I write should live in a git repo I control, in plain markdown, not loc…
Tech news from the best sources
Here is a principle I keep coming back to: the canonical version of everything I write should live in a git repo I control, in plain markdown, not loc…
Moji was born from a simple need: to open a Markdown file with the same convenience as opening a PDF. Double-click the file, view the fully formatted …
Most mind-mapping tools treat Markdown as an export option — something you get out at the end, one-way. I wanted the opposite: I wanted my mind map to…
Markdown to HTML: The Fastest Way to Convert Markdown Online Markdown is one of the easiest ways to write documentation, blog posts, README files, and…
Here's an absurd thing I did for years. I'd test an endpoint with a cURL command. It worked. Then, to document it, I'd open a Markdown file and retype…
I've reviewed hundreds of GitHub READMEs while contributing to open source, and the difference between a forgettable one and one that makes people sto…
Introducing MDConvertHub: Free Browser-Based Markdown Tools for Developers Markdown has become the standard for writing README files, project document…
On Hacé Cuentas (hacecuentas.com) I render 1,200+ pages of user-facing explanation text from JSON content. Every page has at least one markdown table …
If you’ve ever exported from Notion or Obsidian, you know the pain: extra whitespace everywhere, empty links, inconsistent heading styles, and stray H…
Mermaid is a text-based diagramming tool for people who would rather write diagrams than drag boxes around a canvas. It uses a Markdown-like syntax to…
You rename a file, restructure a folder, tweak a heading — and quietly leave a trail of dead links across your README and docs. Nobody notices until a…
Last week Google Cloud published the Open Knowledge Format (OKF). It is a way to write down what a team knows so that AI agents can read it. Strip the…
When building a modern SaaS product with an AI assistant ("Ask our docs"), you quickly hit a brutal realization about documentation design: Humans wan…
Managing large collections of Markdown documents (documentation sites, knowledge bases, notes) often means resorting to a messy combination of grep an…
Have you ever copy-pasted from a PDF only to get mangled line breaks, tables collapsed into a single line, formulas turned into gibberish, and figure …
HTML is an excellent output format. As an authoring format, though, it can become noisy when you're building simple documentation sites, landing pages…
Thoughtworks Technology Radar Vol 34 put Typst in the Trial ring. It's the modern typesetting language people are jumping to from LaTeX, partly becaus…
I got caught flat-footed twice by the same customer. I have an office hours call with them almost every week. For a couple of weeks in a row they aske…
Most note-taking tools feel disconnected from actual development workflow. I constantly ended up with: debugging notes in random files temporary snipp…
The drift problem Every project that ships a translated README has the same lifecycle: Someone writes README.md in English. A contributor opens a PR w…