Queries
Dynamic results inside markdown without storing duplicated content
Queries are placeholders for live content in Markdown. Looksyk calculates the result at runtime and renders it inline, while only the query syntax is stored in the markdown file on disk.
- Keep lists, counts and references up to date automatically
- Embed files, media and other derived content directly in your notes
- Turn captured markdown data into boards, charts and filtered overviews
When queries are especially useful
- Continuously changing content
Use queries when results should update automatically across your graph, for example open todos for a tag or subpages below a root page.
- Content outside the current markdown block
Insert things that are stored elsewhere, such as file contents, code snippets, audio or video assets, without copying them into the page.
- Views that markdown alone cannot express
Build derived representations like kanban board links, progress indicators, property plots or compact summary counts.
Available query guides
Open the guide that matches the result you want to render. Each page documents the supported syntax and parameters for that query type.
Workflow
Query Boards
Create a configured kanban-style board link from tagged markdown blocks and page properties.
Visualization
Plot Mermaid Diagrams
Plot mermaid diagrams ad hoc and seamlessly integrate them as SVGs with your color theme into your page.
Visualization
Plot Page Properties
Read numeric journal page properties over time and render them as a line chart inside your notes.
Filtering
Query Blocks
Insert blocks that contain a specific tag and display them as cards, paragraphs, lists or counts.
Structure
Query Page Hierarchy
Show child pages below a root tag and render them as an in-place list or as a simple count.
References
Query Backlinks
Display references to pages with a specific tag, similar to the backlinks section at the bottom of a page.
Progress
Query Todo Progress
Measure completion progress for todos below a tag and render a compact visual progress indicator.
Tasks
Query Todos
List open or done todos as referenced lists, in-place lists or counts, depending on your workflow.
Assets
Query Assets
Render text, code, video or audio files inline when the content should appear inside the markdown block.
Current syntax limitation
Queries currently need to be written exactly as documented. Parameters cannot yet be reordered or omitted, so it is best to copy the documented query pattern and then adapt the values.