This guide walks you through connecting your Obsidian vault to the wiki so that notes you write locally appear here automatically whenever you push to git.

What you need

Obsidian installed
Git installed on your machine
Access to the wiki's git repository (ask the admin to add your Google account first)

Step 1 — Clone the repository

Open a terminal and clone the wiki repo:

git clone https://github.com/AjinkyaRanshur/wikipage.git
cd wikipage

Step 2 — Open the folder as an Obsidian vault

Open Obsidian
Click Open folder as vault
Select the wikipage folder you just cloned

Your vault is now the entire repo. You'll see the content/ folder in the file explorer.

Step 3 — Install the Obsidian Git plugin

In Obsidian, go to Settings → Community plugins
Turn off Safe mode if prompted
Click Browse and search for Obsidian Git
Install and enable it

Step 4 — Configure Obsidian Git

Go to Settings → Obsidian Git and set:

Vault backup interval: 30 (auto-commits every 30 minutes)
Auto push on backup: enabled
Pull on startup: enabled

This means every 30 minutes Obsidian will commit any changes and push them to GitHub, which triggers a Cloudflare build and your pages appear on the wiki within a couple of minutes.

You can also push manually at any time: Cmd+P (Mac) or Ctrl+P (Windows) → type Git Push → Enter.

Step 5 — Write your first page

Create a new file inside content/public/ and add this frontmatter block at the very top:

---
title: My first page
category: blog
access: public
tags: [tag1, tag2]
description: A short one-line summary shown on the wiki homepage.
updated: 2025-05-11
---

Your content goes here. Standard markdown works: **bold**, *italic*, headings, lists, code blocks.

Save the file. Obsidian Git will pick it up on the next auto-push cycle, or push manually right away.

Access levels

`access` value	Who can see the page
`public`	Everyone, no sign-in required
`research` (or any team name)	Only people the admin has added to that team
`private`	Admin only

To write a page for a specific team, place it in content/{team}/ and set access: {team} in the frontmatter. For example, a page for the research team goes in content/research/my-page.md with access: research.

Frontmatter reference

Field	Required	Notes
`title`	yes	Shown as the page heading
`category`	yes	Groups pages in the sidebar (e.g. `blog`, `research`, `guide`)
`access`	yes	`public`, a team name, or `private`
`description`	no	One-line summary on the index cards
`tags`	no	Array, e.g. `[obsidian, tools]`
`updated`	no	Date label, e.g. `2025-05-11`

Troubleshooting

Page not appearing after push Check the Cloudflare Pages build log — go to your Pages project dashboard and look at the latest deployment. If the build failed, the log will show why.

Git asks for credentials Set up a GitHub personal access token with repo scope and use it as your password when git prompts you.

Obsidian Git not pushing automatically Make sure the plugin is enabled and the interval is set. You can check the plugin's status bar item at the bottom of the Obsidian window.