--- title: "BlogSeq" description: "A Logseq plugin that exports pages to portable Markdown, resolving references and bundling images and other assets; the current release is DB-version-only…" url: "https://briansunter.com/projects/blogseq" --- Sep 1, 2025 Launched Status checked Sep 15, 2026 # BlogSeq A Logseq plugin that exports pages to portable Markdown, resolving references and bundling images and other assets; the current release is DB-version-only pre-alpha. [View Source](https://github.com/briansunter/blogseq) TypeScript React Logseq Plugin Markdown  ## Overview BlogSeq exports a Logseq page to portable Markdown. Properties become YAML frontmatter, block and page references resolve to readable text, and every image referenced anywhere in the tree (including UUID-based references buried in properties) is found and bundled into an `/assets/` folder, with all paths rewritten to point at it. I built it because publishing from Logseq used to mean copy-pasting Markdown and then chasing down broken images by hand. BlogSeq makes the export hand-off zero-touch. The current repository describes the plugin as DB-version-only and pre-alpha; its public marketplace and release artifacts make that prerelease usable, but it should not be read as a stable release claim. ## Release status The current repository is marked **DB Version Only | Pre-Alpha Release**. It is installable from the Logseq marketplace or from the project release artifacts, so this page records a usable prerelease rather than a stable release. ## Features ### Asset bundling The thing that took the most work to get right: - Walks blocks, properties, and nested references for image links - Resolves UUID-based asset references to real files on disk - Drops everything into a single `/assets/` directory - Rewrites links in the Markdown to relative paths ### YAML frontmatter Logseq page properties come out as standard YAML frontmatter. Slot it straight into Jekyll, Hugo, Astro, or anything else that expects frontmatter at the top of a file. ### Reference resolution - `((block-references))` resolved to the referenced block’s text - `[[page links]]` rendered as readable text - Nested and recursive references handled - Image references-by-UUID inside properties resolved ### Live preview See the rendered Markdown before exporting. ## Export Options - Copy to clipboard - Download a single `.md` - Download a `.zip` with the Markdown plus every asset ## Configuration - Page name as H1 - Flatten blocks into paragraphs - Include / exclude properties - Preserve or strip Logseq-specific markup - Resolve or keep block / page references ## Technology Stack - React 18 + TypeScript - Vite - Tailwind CSS - JSZip for the bundle - Logseq Plugin API ## Related projects - [Logseq YouTube Captions](/projects/logseq-youtube-captions) [A released Logseq plugin that downloads YouTube captions into a child block, with slash and block-menu commands and configurable caption language.](/projects/logseq-youtube-captions) - [Logseq GPT-3 Plugin](/projects/logseq-gpt3-plugin) [A released Logseq plugin that sends block prompts to OpenAI text models and inserts responses as child blocks; the current project is a legacy GPT-3 integration.](/projects/logseq-gpt3-plugin) - [Obsidian CSV Editor](/projects/obsidian-csv-editor) [An Obsidian plugin that opens .csv files in a spreadsheet-like grid with keyboard navigation, range selection, copy/paste, sorting, and debounced auto-save.](/projects/obsidian-csv-editor) ## Share this project