wiki-export

Export an Obsidian wiki's wikilink graph to JSON, GraphML, Cypher, SQL, and HTML formats.

Updated Nov 9, 2023
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill wiki-export-oresttokovenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wiki-export
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/wiki-export
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill wiki-export-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Knowledge stored in an Obsidian wiki is locked inside wikilinks and Markdown files, making it hard to analyze or visualize in external tools like Gephi, Neo4j, or Postgres. This Skill converts the vault's link structure into standard graph formats and an optional lossless markdown bundle. ## Core Features & Use Cases - Multi-format graph export: Generates graph.json (NetworkX), graph.graphml (Gephi/yEd), cypher.txt (Neo4j), postgres.sql (idempotent upserts), and an interactive graph.html visualization in one run. - Typed edges and communities: Promotes relationships: frontmatter entries to semantic edge types (contradicts, extends, derived_from) and assigns community IDs by dominant tag for coloring. - Filtering and OKF bundle: Supports project-based and visibility-based filters, plus an optional lossless OKF markdown bundle with wikilinks rewritten as relative Markdown links for MkDocs, Notion, or GitHub. - Use Case: You maintain a research wiki in Obsidian and want to explore topic clusters visually. Run the export, open graph.html in a browser to see community-colored nodes, then load graph.graphml into Gephi for deeper analysis. ## Quick Start Ask the assistant to export the wiki knowledge graph to JSON, GraphML, Neo4j, Postgres, and an interactive HTML visualization.

Frequently Asked Questions about wiki-export

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I export an Obsidian vault to Neo4j or Gephi?

Run the wiki export to generate cypher.txt with MERGE statements for Neo4j and graph.graphml for Gephi, yEd, or Cytoscape. Load the Cypher file with cypher-shell or paste it into Neo4j Browser, and import the GraphML file directly into Gephi.

How to visualize an Obsidian knowledge graph in a browser?

The export writes a self-contained graph.html file using the vis.js CDN that opens in any browser without a server. Nodes are colored by tag-based community, sized by link degree, and clicking a node shows its category, tags, and summary.

Can I export only one project or exclude internal pages?

Yes, pass a project name to filter pages by path prefix or tag, or request a public export to exclude pages tagged visibility/internal or visibility/pii. Edges pointing to excluded pages are dropped, and the summary notes which filters were applied.

What is the difference between the graph export and the OKF bundle?

The graph files (JSON, GraphML, Cypher, SQL) are a lossy projection containing only nodes and edges. The OKF bundle under wiki-export/okf/ preserves full page bodies with wikilinks rewritten as relative Markdown links, enabling lossless round-trip import and use in MkDocs, Notion, or GitHub.

Is the Postgres export safe to re-run?

Yes, postgres.sql uses INSERT ... ON CONFLICT DO UPDATE upserts for both wiki_pages and wiki_edges tables, so re-running the export updates existing rows instead of failing or duplicating data. The composite primary key (source, target, relation) keeps typed and untyped edges as distinct rows.