Create and edit LogSeq block-based markdown with properties, wikilinks, block references, embeds, tasks, and namespaces. Use when working with .md files in a LogSeq graph, or when the user mentions LogSeq blocks, properties, namespaces, or journal pages.
Instrucciones de origen · Vista previa de solo lectura
name
logseq-markdown
description
Create and edit LogSeq block-based markdown with properties, wikilinks, block references, embeds, tasks, and namespaces. Use when working with .md files in a LogSeq graph, or when the user mentions LogSeq blocks, properties, namespaces, or journal pages.
LogSeq Block-Based Markdown
LogSeq uses a block-based outliner approach to markdown. Every piece of content is a block (a bullet point), and indentation creates parent-child relationships. This is fundamentally different from document-based editors like Obsidian.
Block Structure
Every line in a LogSeq markdown file is a block, prefixed with - :
- This is a top-level block
- This is a child block (indented with tab)
- This is a grandchild block
- Another child block
Critical rules:
Use tabs (not spaces) for indentation in LogSeq markdown files
Every block gets a unique UUID automatically assigned by LogSeq
Pages are root-level containers; every block belongs to a page
Journal pages use date-based filenames (e.g., 2026_02_12.md)
Date links use ISO format: [[2026-02-12]] (configured via :journal/page-title-format "yyyy-MM-dd")
Page files go in pages/ directory, journal files in journals/ directory
Note: Headings are less commonly used in LogSeq since the outliner structure provides hierarchy naturally.
Page References
[[page name]] Basic page reference (creates page if missing)
#tag Single-word tag (equivalent to [[tag]])#[[multi word tag]] Multi-word tag
[display text]([[page name]]) Labeled page reference
Tags and page references are functionally identical in LogSeq — #project and [[project]] both create/link to the same page.
Block References
((block-uuid)) Reference a block by its UUID
[display text](((block-uuid))) Labeled block reference
Block references render the referenced block's content inline. Type (( to trigger autocomplete search.
Embeds
{{embed [[page name]]}} Embed entire page content
{{embed ((block-uuid))}} Embed a single block and its children
Embeds render the full content inline (editable in place), unlike references which are read-only links.
Links and Images
[link text](https://example.com) External link
 Local image
 Remote image
Bare URLs are automatically converted to clickable links.
Properties
Properties use key:: value syntax (note the double colon).
Page Properties
Must be in the first block of the page. They annotate the entire page:
- title:: My Project
tags:: [[project]], [[active]]
alias:: My Proj, MP
type:: documentation
status:: in-progress
Block Properties
Can be on any block. They annotate only that block:
- Buy groceries
priority:: A
due-date:: [[2025-01-15]]
estimated-time:: 30min
$E = mc^2$ Inline math
$$\int_0^\infty e^{-x} dx = 1$$ Block/display math
LogSeq uses KaTeX for rendering LaTeX expressions.
Tables
Standard markdown pipe-delimited tables:
- | Header 1 | Header 2 | Header 3 |
|----------|:--------:|---------:|
| Left | Center | Right |
| Cell | Cell | Cell |
Blockquotes
Markdown style:
- > This is a blockquote
> Second line
Org-mode style:
- #+BEGIN_QUOTE
This is a blockquote
#+END_QUOTE
Advanced Commands (Admonition Blocks)
Type < in a block to access these org-mode style commands:
- #+BEGIN_NOTE
This is a note
#+END_NOTE
- #+BEGIN_TIP
This is a tip
#+END_TIP
- #+BEGIN_IMPORTANT
This is important
#+END_IMPORTANT
- #+BEGIN_CAUTION
Exercise caution
#+END_CAUTION
- #+BEGIN_WARNING
This is a warning
#+END_WARNING
- #+BEGIN_PINNED
Pinned content
#+END_PINNED
Macros
Define custom macros in logseq/config.edn under :macros:
