M mdspec blog
All articles

Tag

Notion

3 articles

mdspec GitHub Actions

mdspec in 5 Minutes: From Zero to Publishing Markdown on Every Merge

A screencast-style walkthrough: create a repo, add one .mdspecmap, add the GitHub Actions step, push a commit, see it appear in Confluence or Notion. Real YAML throughout.

6 min read
Notion GitHub

Notion's GitHub Integration Is Read-Only: 5 Workarounds for Actually Publishing Markdown from Your Repo

Notion's native GitHub integration can't push markdown content into Notion pages. Here are five real workarounds, ranked by how far they'll get you — with no hype about what each one actually can't do.

9 min read
Spec Drift Documentation

Spec Drift: Why Your Markdown Files and Your Notion/Confluence Pages Stop Matching (And What to Do About It)

Spec drift isn't a discipline problem — it's an architectural one. Here's how to name it, audit for it, and fix it structurally so it stops coming back.

9 min read