makeplane / makeplane/plane

GitHub markdown -> Plane Pages sync with public API support

Open
#8,815 5 comments 3 reactions 1 assignee View on GitHub

@Saurabhkmr98 is already working on this.

Since Mar 30, 2026.

Dominant language
TypeScript
Stars
59.6k
Forks
5.8k
Avg merge
1d 22h
Merged PRs (30d)
49

Description

We need first-class syncing from GitHub markdown files into Plane Pages.

Current problem:

  • Pages are the natural target for docs, design systems, reference content, runbooks, and release notes.
  • In practice, the public/API-key surface appears insufficient for unattended page management.
  • That forces automation users to either rely on unsupported browser/session workarounds or use work items as a docs substitute.

Requested capability:

  1. Sync markdown files from a GitHub repo into Plane Pages.
  2. Map files to stable Plane pages by repo path or external ID.
  3. Support create, update, list, and archive/delete through the public/API-key surface.
  4. Support folder -> nested page hierarchy.
  5. Support one index/root page plus child pages.
  6. Preserve page identity and URL across updates.
  7. Optionally expose sync status, last synced commit SHA, and source link.

Why this matters:

  • design systems
  • product docs
  • runbooks
  • release notes
  • board/company knowledge bases
  • operational manuals

Real-world example:
We just had to build repo -> Plane automation using work items because they support stable API-key mutation, even though Pages are the correct product surface for this kind of content. A native GitHub markdown -> Pages sync would be a much better solution.

The key ask here is not just page CRUD. It is a docs-native automation path that makes Plane Pages a durable destination for repository-backed knowledge.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.