Logseq Profile

The Logseq profile makes WikiMason work with Logseq graph directories.

Path mapping

Logseq stores pages flat in pages/. Namespaces are encoded into filenames:

PageRef("Wiki/Tech/Strapi")  ->  pages/Wiki___Tech___Strapi.md
pages/Wiki___Tech___Strapi.md  ->  PageRef("Wiki/Tech/Strapi")

The namespace separator defaults to ___ (triple underscore) and can be configured in [profile.logseq].

Metadata format

Logseq uses property:: value lines at the top of each page:

type:: knowledge
domain:: tech
confidence:: high
created:: 2026-05-29
updated:: 2026-05-29

- ## Deployment Pipeline
  - CI/CD workflow for production.

Properties are parsed from the top of the file until a non-property block is encountered. Lists (tags, sources, topics, aliases) use comma-separated values.

Body rendering

The Logseq profile converts internal standard Markdown to outliner blocks:

Headings: - ## Heading (nested)
Lists: nested with block depth
Code fences: preserved as child blocks
Tables: nested under a parent block

Note

WikiMason preserves Markdown-like structure internally, but Logseq’s visual editor may render nested tables and fenced code blocks differently. Prefer small, simple blocks in Logseq-authored pages.

Init layout

wikimason init logseq creates:

pages/
  Wiki___index.md
  Wiki___Dashboard.md
  Wiki___Tech.md
  Wiki___Projects.md
  Wiki___Schema.md
journals/             (optional)
Raw/Sources/
Schema/
_templates/
AGENTS.md
wikimason.toml

Profile changes

WikiMason does not expose profile migration commands in the current pre-release surface. To move between profiles, create a fresh target vault and then use canonical verification/build commands after copying content:

wikimason source verify
wikimason index build
wikimason lint