Skip to content

YU000jp/logseq-plugin-graph-sieve

Repository files navigation

Logseq Graph Sieve Plugin

Helper tool to extract and normalize plain text from a file‑based graph’s pages and journals folders using a simple card + preview interface.

日本語 | English

What is it?

Graph Sieve combines page discovery and normalization in one screen:

  • Folder Mode (read‑only): choose your Logseq graph folder and browse pages without running Logseq
  • Remove/normalize: properties, page refs, query blocks, renderers, [[Page]] brackets
  • Extra normalization: always‑hide property keys, arbitrary string removal, task normalization, macro removal
  • Helpful extras: preview tabs, related/sub‑pages, tab management, favorites

It’s a feature‑extended derivative of the CardBox plugin with a redesigned internal structure and settings model.

Usage

  1. Launch from the Logseq toolbar icon.

The icon may be hidden by default

  1. Choose a folder
  • Click “Folder Mode” and select your graph’s root folder (it must contain a pages directory)
  1. Work with cards
  • Empty pages aren’t listed
  • Click or move selection and press Enter to open a page in the right‑hand preview (opens as a tab)
  1. In a tab
  • Switch view type (Content / No Markdown / RAW)
  • Copy content, close all tabs, etc.

Preview tab types

  • Content: Logseq‑like rendering (with property/ref hiding applied)
  • No Markdown: Plain text with markup removed
  • RAW: Processed raw markdown

Text formatting / display options

Settings are persisted to localStorage.

  • Hide properties
  • Always hide properties (comma‑separated keys)
  • Strip [[ ]] brackets ([[Page Title]] → Page Title)
  • Enable page links
  • Hide page refs
  • Hide queries ({{query ...}})
  • Hide renderers (e.g., {{renderer ...}})
  • Remove macros (non‑query/custom macros)
  • Normalize tasks (TODO/DOING/DONE… → Markdown checkboxes)
  • Remove strings (filter substrings from body and copy output)

Limitations / Notes

  • Folder Mode does not fully reproduce Logseq’s hierarchy/metadata.
  • Whiteboards and temporary in‑progress files are ignored.
  • Some formatting may differ slightly from Logseq’s native rendering.

Credits

  • Based on / inspired by: CardBox by sosuisen
  • Libraries: React, Dexie, Material UI, @logseq/libs

Author

Author: YU000jp

About

It is a flexible means of migrating pages from older file-based graphs into the Logseq DB model as plain text.

Topics

Resources

License

Stars

Watchers

Forks

Contributors 3

  •  
  •  
  •  

Languages