CodeWF.MindView 12.0.3.6

Zhijian

Zhijian is a local, Markdown-first mind-map editor built with C# and Avalonia. It keeps the outline, Markdown text, and graphical mind map synchronized over the same document model, so users can write structure quickly and inspect the result visually.

Chinese documentation: README.zh-CN.md

Repository: https://github.com/dotnet9/Zhijian

Highlights

• Starts with the bundled 使用手册.md, so the first screen demonstrates a real multi-level mind map.
• File menu for New, New Window, Open, Open Folder, Recent Files, Save, Save As, Open File Location, and Close.
• Edit menu for Undo, Redo, Add Sibling, Add Child, Promote, Demote, Move, Delete, and Copy as Markdown.
• Theme, Language, Help, and About menus are grouped in the title bar with icons and shortcuts where useful.
• Language switching uses Lang.Avalonia.Json resources for Simplified Chinese, Traditional Chinese, English, and Japanese.
• First-run onboarding precisely highlights the title-bar File menu, outline editor, Markdown switch, mind-map canvas, and bottom navigation, and includes a Skip button.
• src/Zhijian/App.config centralizes onboarding, default language, recent-file count, history depth, and runtime state file names.
• Files and Outline tabs on the left: individually opened files appear in the file list, and opening a folder lists every supported mind-map file in that folder.
• Outline, Markdown, and mind-map views share the same MindMapNode tree.
• Inline title and note editing in both outline and mind-map views.
• User-friendly outline and mind-map menus for adding siblings or children, promoting or demoting nodes, moving nodes, editing notes, and deleting nodes.
• Mind-map panning, zooming, center-topic navigation, and a real mini-map based on current node coordinates.
• Copy as Markdown writes the current document Markdown to the clipboard and shows a desktop global message.
• Markdown, OPML, and XMind open/save support.
• Desktop shell with title-bar menus, dialogs, list controls, tooltips, global messages, and dark theme.
• Reusable CodeWF.MindView controls depend only on Avalonia and stay separate from the desktop shell.

Runtime Preview

The screenshots and GIFs below were refreshed against the current UI with the bundled manual loaded by default, so the file list, mini-map, zoom, and canvas-panning behavior are easier to inspect.

Editing Workflow

The left pane is the main writing area. Use outline mode for structured editing, switch to Markdown when text-first editing is faster, and use the right mind-map canvas for visual inspection.

Useful keyboard behavior while editing a node title:

• Enter: add a sibling node. If the selected outline node has children, Zhijian adds a child node.
• Tab: add or demote to a child node.
• Shift + Tab: promote a node.
• Delete or Backspace: delete an empty non-root node.
• ⌘ + mouse wheel on macOS or Ctrl + mouse wheel on Windows/Linux: zoom the mind-map canvas.
• Space + left drag: pan the mind-map canvas.
• ⌘ + L on macOS or Ctrl + L on Windows/Linux: return to the center topic.

File Formats

Zhijian uses Markdown as the default readable format and can exchange data with common mind-map tools:

• Markdown (.md, .markdown)
• OPML (.opml, .xml)
• XMind (.xmind)

Reusing CodeWF.MindView

src/CodeWF.MindView is independent from the application shell. A new Avalonia app can reference CodeWF.MindView and CodeWF.MindView.Themes, register <mindThemes:MindViewThemes /> in App.axaml, and place MindMapEditor in a view. Basic integration only needs roots and the current selection:

<mind:MindMapEditor
    Roots="{Binding Roots}"
    SelectedNode="{Binding SelectedNode, Mode=TwoWay}" />

MindMapEditor includes basic child/sibling creation, promotion, demotion, sibling reordering, deletion, drag/drop moves, and automatic layout. Add Controller="{Binding}" only when the host needs to connect undo history, dirty state, or custom business rules through IMindMapEditorController. The src/Zhijian app is the complete reference for file workflow, outline editing, Markdown synchronization, title-bar menus, and desktop shell integration around the reusable control.

See docs/source-design.md for the reusable-control integration details.

Project Structure

Zhijian/
|-- src/CodeWF.MindView/        reusable mind-map controls and document codecs
|-- src/CodeWF.MindView.Themes/ default resources for CodeWF.MindView
|-- src/Zhijian/                Zhijian desktop application
|-- docs/                       architecture and source-design documentation
|-- docs/media/                 runtime screenshots and GIFs
|-- CHANGELOG.md                English changelog
|-- CHANGELOG.zh-CN.md          Chinese changelog
`-- Zhijian.slnx                solution file

Open Source Thanks

Zhijian is built on excellent open source platforms and libraries:

• Dotnet
• Avalonia UI
• Semi.Avalonia
• Ursa.Avalonia
• AtomUI

Development

Requirements:

• .NET 10 SDK

Common commands:

dotnet restore Zhijian.slnx
dotnet build Zhijian.slnx
dotnet run --project src/Zhijian/Zhijian.csproj -f net10.0

Documentation

• Architecture
• Architecture Chinese
• Source Design
• Source Design Chinese