Skip to content

Choosing a Format

GraphScribe can export the same asset in five different formats. They each serve a different purpose. Pick the one that matches what you’re trying to do. You choose the format in the export dialog’s Format combo (you can set a default format).

The export dialog with the Format combo

FormatFile extensionBest forReadable by humans?Readable by AI/tools?
Markdown.mdAI agents, code review, documentation, PRsYesYes
Graphify.graphify.jsonKnowledge graphs and AI agentsSomewhatYes
Obsidian.md vaultBrowsing a project like a wiki, visual graphsYesYes
Mermaid.mmdDiagrams that render on GitHub, GitLab, NotionYes (as a diagram)Yes
JSON.jsonCustom tools and scriptsNot reallyYes

The human-friendly option. Variables, functions, graphs, macros, delegates, class references, and widget trees become clean Markdown sections. This is the format you’ll read the most. See Markdown Output.

A knowledge graph format designed for AI and graph databases. Unlike the other formats, Graphify:

  • gives every Blueprint, function, and class a stable ID (bp: / fn: / cls:),
  • records links between assets (calls, defines, uses, plus per-asset contains),
  • can merge every exported file into one project-wide graph (ProjectLinkage.graphify.json),
  • writes the graphify-ready graphify-out/graph.json wrapper so the graphify CLI can render an interactive graph.html viewer of the whole project (auto-run by the editor when Generate Graphify Viewer is on).

This is what lets AI answer “who calls this function?” across your whole project. See Graphify: AI-Ready Graphs, and Graphify: Install & Use to load the exports into the Graphify tool.

A multi-file vault for the free Obsidian app: one note per asset plus sub-notes for every function, event, and macro, connected by [[wikilinks]] so Obsidian’s native graph view renders your whole project architecture. Great for browsing a project like a wiki. Obsidian is batch-only, vaults are written by the folder exporter, not the single-asset dialog. See Obsidian Vaults.

A flowchart description that renders as a diagram anywhere Mermaid is supported. GitHub READMEs, GitLab, Notion, and more. Great for putting a visual of a Blueprint graph or widget hierarchy into a document. See Mermaid Diagrams.

A complete, structured dump of everything in the asset. Nodes, pins, edges, variables, class refs, widget tree, diagnostics, and more. Use this if you’re writing your own tooling to process Blueprint data. It’s verbose and not meant to be read by people. See JSON Output.

Almost. Every format exports the full asset, but some things are format-specific:

  • Graphify filters out Kismet utility noise (Branch, Sequence, Get/Set nodes, Kismet*Library calls) so the graph keeps only gameplay linkage. Markdown/Mermaid/JSON keep the full node set.
  • Obsidian is a vault of linked notes (batch export only). Each note’s logic walk keeps the full node set, and the notes embed Mermaid diagrams of the flow.
  • Selection exports contain only the selected nodes and omit variables, widget trees, and class references in every format.
  • DataTables are never exported in any format.
  • Writing docs or reviewing code → Markdown
  • Feeding AI or a knowledge base → Graphify
  • Browsing a project visually → Obsidian
  • Showing a visual diagram → Mermaid
  • Building a tool → JSON