logseq-to-obsidian 0.1.0__tar.gz

logseq_to_obsidian-0.1.0/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2025 Georg Lutz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

logseq_to_obsidian-0.1.0/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.3
+Name: logseq-to-obsidian
+Version: 0.1.0
+Summary: Convert a Logseq vault to Obsidian-friendly Markdown
+License: MIT
+Author: Georg Lutz
+Author-email: georg@georglutz.de
+Requires-Python: >=3.9,<4.0
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Text Processing :: Markup :: Markdown
+Classifier: Topic :: Utilities
+Project-URL: Homepage, https://github.com/sercxanto/logseq-to-obsidian
+Project-URL: Repository, https://github.com/sercxanto/logseq-to-obsidian.git
+Description-Content-Type: text/markdown
+
+# Logseq → Obsidian Converter
+
+![tests](https://github.com/sercxanto/logseq_to_obsidian/actions/workflows/tests.yml/badge.svg)
+![lint](https://github.com/sercxanto/logseq_to_obsidian/actions/workflows/lint.yml/badge.svg)
+[![codecov](https://codecov.io/gh/sercxanto/logseq_to_obsidian/graph/badge.svg?token=bTE5A3niNf)](https://codecov.io/gh/sercxanto/logseq_to_obsidian)
+
+## Overview
+
+- Converts a Logseq vault (Markdown flavor) to Obsidian-friendly Markdown.
+- Handles page properties → YAML front matter, task statuses, block IDs, and block references.
+- Preserves non-page folders; moves `pages/` content to the vault root.
+
+## Features
+
+- Page properties (`key:: value`) at top → YAML front matter.
+- Special mappings:
+    - `alias::` or `aliases::` → `aliases: []` (array)
+    - `tags::` → `tags: []` (array, without `#`)
+    - `title::` → omitted (Obsidian only uses the filename as the note name). If the Logseq title mismatches the vault-relative output path, a warning is emitted so you can tidy it up.
+- Task markers:
+    - Recognized at the start of a list item (`- STATE ...`, uppercase only):
+        - `TODO`, `DOING`, `LATER`, `NOW`, `WAIT`, `WAITING`, `IN-PROGRESS` → `- [ ] ...`
+        - `DONE`, `CANCELED`, `CANCELLED` → `- [x] ...`
+    - Priorities right after state (`[#A|#B|#C]`):
+        - Emoji: A→`⏫`, B→`🔼`, C→`🔽` (appended at end)
+        - Dataview: `[priority::high|medium|low]` (appended at end; omitted if none)
+    - Dates anywhere after the state:
+        - `SCHEDULED: <YYYY-MM-DD [Dow] [HH:MM] [repeater]>` → Emoji: `⏳ YYYY-MM-DD[ HH:MM]`; Dataview: `[scheduled::YYYY-MM-DD[ HH:MM]]`
+        - `DEADLINE: <YYYY-MM-DD [Dow] [HH:MM] [repeater]>` → Emoji: `📅 YYYY-MM-DD[ HH:MM]`; Dataview: `[due::YYYY-MM-DD[ HH:MM]]`
+        - Repeaters: `. +N<u>` or `++N<u>` → “every N <unit> when done”; `+N<u>` → “every N <unit>”
+        - Units: `y`=year(s), `m`=month(s), `w`=week(s), `d`=day(s), `h`=hour(s); pluralized when N ≠ 1
+        - Ordering: append priority, then scheduled, then due, then repeat; block anchors (e.g., `^id`) remain last
+- Block IDs:
+    - `id:: <uuid>` lines are converted to Obsidian block anchors by appending `^<uuid>` to the owning block line.
+- Block references:
+    - `((<uuid>))` → `[[<FileName>#^<uuid>]]` (resolved by scanning all files first).
+    - Optional: convert configured wikilinks `[[key/value]]` to Dataview inline fields `[key::value]` (non-embed, no alias, not inside code blocks).
+- Embeds:
+    - `{{embed ((<uuid>))}}` → `![[<FileName>#^<uuid>]]`
+    - `{{embed [[Some Page]]}}` → `![[Some Page]]`
+- Images in assets:
+    - `![alt](../assets/image.png)` or `![alt](assets/image.png)` → `![[image.png]]` (alt text is not preserved)
+    - With size attributes: `![alt](../assets/image.png){:height H, :width W}` → `![[image.png|WxH]]` (width × height)
+- Headings followed by indented lists:
+    - If a heading line is immediately followed by an indented list (≥4 spaces or tabs), prefix the heading with `- ` (i.e., `- # Heading`).
+    - Rationale: Logseq treats such lists as children of the heading; Obsidian otherwise renders them as quoted/code blocks. This keeps folding behavior aligned.
+- Journals:
+    - Renames `YYYY_MM_DD.md` → `YYYY-MM-DD.md` and can move journals to a specific folder.
+- Assets and other files are copied as-is.
+
+## Installation
+
+- pipx (recommended): `pipx install logseq-to-obsidian`
+- pip: `pip install logseq-to-obsidian`
+- From Git (development version): `pipx install "git+https://github.com/sercxanto/logseq_to_obsidian.git@main"`
+
+## Usage
+
+```
+logseq-to-obsidian \
+  --input /path/to/logseq-vault \
+  --output /path/to/obsidian-vault \
+  --daily-folder "Daily Notes" \
+  --tasks-format emoji \
+  --field-key project \
+  --field-key topic \
+  --dry-run
+```
+
+Alternatively (no console script), you can run:
+
+```
+python -m logseq_to_obsidian \
+  --input /path/to/logseq-vault \
+  --output /path/to/obsidian-vault \
+  --dry-run
+```
+
+## Options
+
+- `--input`: Path to the Logseq vault root (folder containing `pages/`, `journals/`, etc.).
+- `--output`: Destination Obsidian vault directory (created if not exists).
+- `--daily-folder <name>`: Move `journals/` into this folder in the output. If omitted, keeps `journals/`.
+- `--tasks-format {emoji|dataview}`: Choose output format for Tasks metadata (priorities now; dates later). Default: `emoji`.
+- `--field-key <key>`: Convert wikilinks of the form `[[key/value]]` to Dataview inline fields `[key::value]`. Repeatable for multiple keys.
+- Pages are always flattened to the vault root; see "File placement rules" below.
+- `--dry-run`: Print planned changes without writing files.
+
+## Notes and assumptions
+
+- Only Markdown (`.md`) files are transformed; other files are copied.
+- Block reference resolution requires that `id::` appears for referenced blocks in the source files.
+- This tool is conservative: it preserves unknown page properties in YAML.
+- Block-level `collapsed::` properties are ignored; Obsidian stores list collapse state outside Markdown.
+
+## Limitations
+
+- Does not parse or migrate the Logseq database; operates purely on Markdown files.
+- Complex block property drawers beyond `id::` are not transformed (left in place).
+- Skips Logseq's internal `logseq/` metadata folder.
+- Skips Logseq whiteboards (`whiteboards/`); a warning is emitted since Obsidian cannot read Logseq's whiteboard format.
+    - Only normalizes heading + indented list patterns outside fenced code blocks; headings already inside list items are left unchanged.
+- File times are preserved: output files keep the original source modification time (mtime) for both transformed Markdown and copied assets.
+
+## File placement rules
+
+- Pages: All files from Logseq's `pages/` are placed at the root of the Obsidian vault.
+- Nested paths: Logseq encodes subfolders in page filenames using three underscores `___`.
+    - Example: `pages/a___b.md` becomes `a/b.md`.
+
+## Journals
+
+- Journal filenames are always renamed from `YYYY_MM_DD.md` to `YYYY-MM-DD.md`.
+- Logseq already displays journal page links using dashes (e.g., `[[2024-08-30]]`), so link text does not need conversion.
+
+## Development / Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md)
+

logseq_to_obsidian-0.1.0/README.md

@@ -0,0 +1,118 @@
+# Logseq → Obsidian Converter
+
+![tests](https://github.com/sercxanto/logseq_to_obsidian/actions/workflows/tests.yml/badge.svg)
+![lint](https://github.com/sercxanto/logseq_to_obsidian/actions/workflows/lint.yml/badge.svg)
+[![codecov](https://codecov.io/gh/sercxanto/logseq_to_obsidian/graph/badge.svg?token=bTE5A3niNf)](https://codecov.io/gh/sercxanto/logseq_to_obsidian)
+
+## Overview
+
+- Converts a Logseq vault (Markdown flavor) to Obsidian-friendly Markdown.
+- Handles page properties → YAML front matter, task statuses, block IDs, and block references.
+- Preserves non-page folders; moves `pages/` content to the vault root.
+
+## Features
+
+- Page properties (`key:: value`) at top → YAML front matter.
+- Special mappings:
+    - `alias::` or `aliases::` → `aliases: []` (array)
+    - `tags::` → `tags: []` (array, without `#`)
+    - `title::` → omitted (Obsidian only uses the filename as the note name). If the Logseq title mismatches the vault-relative output path, a warning is emitted so you can tidy it up.
+- Task markers:
+    - Recognized at the start of a list item (`- STATE ...`, uppercase only):
+        - `TODO`, `DOING`, `LATER`, `NOW`, `WAIT`, `WAITING`, `IN-PROGRESS` → `- [ ] ...`
+        - `DONE`, `CANCELED`, `CANCELLED` → `- [x] ...`
+    - Priorities right after state (`[#A|#B|#C]`):
+        - Emoji: A→`⏫`, B→`🔼`, C→`🔽` (appended at end)
+        - Dataview: `[priority::high|medium|low]` (appended at end; omitted if none)
+    - Dates anywhere after the state:
+        - `SCHEDULED: <YYYY-MM-DD [Dow] [HH:MM] [repeater]>` → Emoji: `⏳ YYYY-MM-DD[ HH:MM]`; Dataview: `[scheduled::YYYY-MM-DD[ HH:MM]]`
+        - `DEADLINE: <YYYY-MM-DD [Dow] [HH:MM] [repeater]>` → Emoji: `📅 YYYY-MM-DD[ HH:MM]`; Dataview: `[due::YYYY-MM-DD[ HH:MM]]`
+        - Repeaters: `. +N<u>` or `++N<u>` → “every N <unit> when done”; `+N<u>` → “every N <unit>”
+        - Units: `y`=year(s), `m`=month(s), `w`=week(s), `d`=day(s), `h`=hour(s); pluralized when N ≠ 1
+        - Ordering: append priority, then scheduled, then due, then repeat; block anchors (e.g., `^id`) remain last
+- Block IDs:
+    - `id:: <uuid>` lines are converted to Obsidian block anchors by appending `^<uuid>` to the owning block line.
+- Block references:
+    - `((<uuid>))` → `[[<FileName>#^<uuid>]]` (resolved by scanning all files first).
+    - Optional: convert configured wikilinks `[[key/value]]` to Dataview inline fields `[key::value]` (non-embed, no alias, not inside code blocks).
+- Embeds:
+    - `{{embed ((<uuid>))}}` → `![[<FileName>#^<uuid>]]`
+    - `{{embed [[Some Page]]}}` → `![[Some Page]]`
+- Images in assets:
+    - `![alt](../assets/image.png)` or `![alt](assets/image.png)` → `![[image.png]]` (alt text is not preserved)
+    - With size attributes: `![alt](../assets/image.png){:height H, :width W}` → `![[image.png|WxH]]` (width × height)
+- Headings followed by indented lists:
+    - If a heading line is immediately followed by an indented list (≥4 spaces or tabs), prefix the heading with `- ` (i.e., `- # Heading`).
+    - Rationale: Logseq treats such lists as children of the heading; Obsidian otherwise renders them as quoted/code blocks. This keeps folding behavior aligned.
+- Journals:
+    - Renames `YYYY_MM_DD.md` → `YYYY-MM-DD.md` and can move journals to a specific folder.
+- Assets and other files are copied as-is.
+
+## Installation
+
+- pipx (recommended): `pipx install logseq-to-obsidian`
+- pip: `pip install logseq-to-obsidian`
+- From Git (development version): `pipx install "git+https://github.com/sercxanto/logseq_to_obsidian.git@main"`
+
+## Usage
+
+```
+logseq-to-obsidian \
+  --input /path/to/logseq-vault \
+  --output /path/to/obsidian-vault \
+  --daily-folder "Daily Notes" \
+  --tasks-format emoji \
+  --field-key project \
+  --field-key topic \
+  --dry-run
+```
+
+Alternatively (no console script), you can run:
+
+```
+python -m logseq_to_obsidian \
+  --input /path/to/logseq-vault \
+  --output /path/to/obsidian-vault \
+  --dry-run
+```
+
+## Options
+
+- `--input`: Path to the Logseq vault root (folder containing `pages/`, `journals/`, etc.).
+- `--output`: Destination Obsidian vault directory (created if not exists).
+- `--daily-folder <name>`: Move `journals/` into this folder in the output. If omitted, keeps `journals/`.
+- `--tasks-format {emoji|dataview}`: Choose output format for Tasks metadata (priorities now; dates later). Default: `emoji`.
+- `--field-key <key>`: Convert wikilinks of the form `[[key/value]]` to Dataview inline fields `[key::value]`. Repeatable for multiple keys.
+- Pages are always flattened to the vault root; see "File placement rules" below.
+- `--dry-run`: Print planned changes without writing files.
+
+## Notes and assumptions
+
+- Only Markdown (`.md`) files are transformed; other files are copied.
+- Block reference resolution requires that `id::` appears for referenced blocks in the source files.
+- This tool is conservative: it preserves unknown page properties in YAML.
+- Block-level `collapsed::` properties are ignored; Obsidian stores list collapse state outside Markdown.
+
+## Limitations
+
+- Does not parse or migrate the Logseq database; operates purely on Markdown files.
+- Complex block property drawers beyond `id::` are not transformed (left in place).
+- Skips Logseq's internal `logseq/` metadata folder.
+- Skips Logseq whiteboards (`whiteboards/`); a warning is emitted since Obsidian cannot read Logseq's whiteboard format.
+    - Only normalizes heading + indented list patterns outside fenced code blocks; headings already inside list items are left unchanged.
+- File times are preserved: output files keep the original source modification time (mtime) for both transformed Markdown and copied assets.
+
+## File placement rules
+
+- Pages: All files from Logseq's `pages/` are placed at the root of the Obsidian vault.
+- Nested paths: Logseq encodes subfolders in page filenames using three underscores `___`.
+    - Example: `pages/a___b.md` becomes `a/b.md`.
+
+## Journals
+
+- Journal filenames are always renamed from `YYYY_MM_DD.md` to `YYYY-MM-DD.md`.
+- Logseq already displays journal page links using dashes (e.g., `[[2024-08-30]]`), so link text does not need conversion.
+
+## Development / Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md)

logseq_to_obsidian-0.1.0/pyproject.toml

@@ -0,0 +1,148 @@
+[project]
+name = "logseq-to-obsidian"
+version = "0.1.0"
+description = "Convert a Logseq vault to Obsidian-friendly Markdown"
+license = "MIT"
+readme = "README.md"
+requires-python = ">=3.9,<4.0"
+classifiers = [
+  "Development Status :: 5 - Production/Stable",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Environment :: Console",
+  "Programming Language :: Python",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Text Processing :: Markup :: Markdown",
+  "Topic :: Utilities",
+]
+authors = [
+  {name = "Georg Lutz", email="georg@georglutz.de"},
+]
+
+[project.urls]
+homepage = "https://github.com/sercxanto/logseq-to-obsidian"
+repository = "https://github.com/sercxanto/logseq-to-obsidian.git"
+
+
+
+[project.scripts]
+logseq-to-obsidian = "logseq_to_obsidian.__main__:main"
+
+[tool.poetry]
+
+package-mode = true
+packages = [
+  { include = "logseq_to_obsidian", from = "src" },
+]
+
+[tool.poetry.group.dev.dependencies]
+ruff = "^0.13.3"
+pytest = "^8.4.2"
+pytest-cov = "^7.0.0"
+pyyaml = "^6.0.3"
+towncrier = "^25.8.0"
+poethepoet = "^0.37.0"
+
+[tool.ruff]
+target-version = "py39"
+line-length = 120
+
+[tool.ruff.lint]
+select = [
+  "E",   # pycodestyle
+  "F",   # pyflakes
+  "I",   # isort (imports)
+  "N",   # pep8-naming
+  "B",   # flake8-bugbear
+  "C4",  # flake8-comprehensions
+]
+ignore = [
+  "E501",  # line length handled by formatter/line-length
+  "F841",  # allow assigned-but-unused (keeps script unchanged)
+]
+
+[tool.pytest.ini_options]
+addopts = "-q --cov=logseq_to_obsidian --cov-branch --cov-report=term-missing --cov-report=xml --cov-fail-under=80"
+testpaths = [
+  "tests",
+]
+
+[tool.coverage.run]
+omit = [
+  "src/logseq_to_obsidian/__main__.py",
+]
+
+[tool.towncrier]
+package = "logseq_to_obsidian"
+package_dir = "src"
+filename = "CHANGELOG.md"
+directory = ".changelog"
+title_format = "## [{version}] - {project_date}"
+issue_format = "#{issue}"
+underlines = ["", "", ""]
+
+[tool.towncrier.fragment.added]
+[tool.towncrier.fragment.changed]
+[tool.towncrier.fragment.deprecated]
+[tool.towncrier.fragment.removed]
+[tool.towncrier.fragment.fixed]
+[tool.towncrier.fragment.security]
+
+[tool.poe.tasks]
+
+[tool.poe.tasks.lint]
+cmd = "ruff check ."
+help = "Run static analysis."
+
+[tool.poe.tasks.fixlint]
+cmd = "ruff check . --fix"
+help = "Run automatic fixes."
+
+[tool.poe.tasks.format]
+cmd = "ruff format ."
+help = "Format source code."
+
+[tool.poe.tasks.test]
+cmd = "pytest"
+help = "Run the test suite."
+
+[tool.poe.tasks.testandlint]
+sequence = ["test", "lint"]
+help = "Run test an lint in one step."
+
+[tool.poe.tasks.bumpversion]
+cmd = "poetry version $increment"
+help = "Bump version in pyproject.toml"
+args = [{ name="increment", positional=true, required=true, help="Either 'major', minor'or 'patch'." }]
+
+[tool.poe.tasks._get_version]
+cmd = "poetry version -s"
+
+[tool.poe.tasks.draftchangelog]
+cmd = "towncrier build --draft"
+help = "List pending news fragments without consuming them."
+
+[tool.poe.tasks.changelog]
+cmd = "towncrier build --yes"
+help = "Build the changelog for the configured version number."
+
+[tool.poe.tasks.commitandtagrelease]
+shell = """
+  git commit -am "Release $VERSION"
+  git tag v$VERSION
+"""
+help = "Commits the changes for the new version"
+uses = { VERSION = "_get_version" }
+
+[tool.poe.tasks.release]
+sequence = ["lint", "test", "bumpversion $increment", "changelog", "commitandtagrelease"]
+args = [{ name="increment", positional=true, required=true, help="Either 'major', minor'or 'patch'." }]
+help = "runs lint + tests, bumps the version, updates 'CHANGELOG.md', commits and tags 'v<version>'"
+
+[build-system]
+requires = ["poetry-core>=1.8.0"]
+build-backend = "poetry.core.masonry.api"

logseq_to_obsidian-0.1.0/src/logseq_to_obsidian/__init__.py

@@ -0,0 +1,44 @@
+from __future__ import annotations
+
+from .cli import main, parse_args
+from .planner import FilePlan, Options, collect_files, copy_or_write, plan_output_path
+from .transformer import (
+    attach_block_ids,
+    build_block_index,
+    emit_yaml_frontmatter,
+    fix_heading_child_lists,
+    normalize_aliases,
+    normalize_tags,
+    parse_page_properties,
+    replace_asset_images,
+    replace_block_refs,
+    replace_embeds,
+    replace_wikilinks_to_dv_fields,
+    transform_markdown,
+    transform_tasks,
+)
+from .version import __version__
+
+__all__ = [
+    "__version__",
+    "FilePlan",
+    "Options",
+    "attach_block_ids",
+    "build_block_index",
+    "collect_files",
+    "copy_or_write",
+    "emit_yaml_frontmatter",
+    "fix_heading_child_lists",
+    "main",
+    "normalize_aliases",
+    "normalize_tags",
+    "parse_args",
+    "parse_page_properties",
+    "plan_output_path",
+    "replace_asset_images",
+    "replace_block_refs",
+    "replace_embeds",
+    "replace_wikilinks_to_dv_fields",
+    "transform_markdown",
+    "transform_tasks",
+]

logseq_to_obsidian-0.1.0/src/logseq_to_obsidian/__main__.py

@@ -0,0 +1,17 @@
+from __future__ import annotations
+
+import sys
+
+from . import main as _main
+
+
+def main() -> int:
+    """Console entry point: dispatch to package `main(argv)`.
+
+    Returns process exit code.
+    """
+    return _main(sys.argv[1:])
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

logseq_to_obsidian-0.1.0/src/logseq_to_obsidian/cli.py

@@ -0,0 +1,129 @@
+from __future__ import annotations
+
+import argparse
+import sys
+from pathlib import Path
+from typing import Dict, List
+
+from .planner import Options, collect_files, copy_or_write
+from .transformer import (
+    build_block_index,
+    replace_asset_images,
+    replace_block_refs,
+    replace_embeds,
+    replace_wikilinks_to_dv_fields,
+    transform_markdown,
+)
+from .version import __version__
+
+__all__ = ["main", "parse_args"]
+
+
+def parse_args(argv: List[str]) -> Options:
+    p = argparse.ArgumentParser(description="Convert a Logseq vault to Obsidian-friendly Markdown.")
+    p.add_argument("--version", action="version", version=f"%(prog)s {__version__}")
+    p.add_argument("--input", required=True, help="Path to Logseq vault root")
+    p.add_argument("--output", required=True, help="Path to destination Obsidian vault root")
+    p.add_argument("--daily-folder", default=None, help="Move journals into this folder name in output")
+    p.add_argument(
+        "--tasks-format",
+        choices=["emoji", "dataview"],
+        default="emoji",
+        help="Format for Tasks plugin metadata (priority, dates)",
+    )
+    p.add_argument(
+        "--field-key",
+        action="append",
+        default=[],
+        help="Convert wikilinks of the form [[key/value]] to Dataview inline fields [key::value] for the given key(s).",
+    )
+    p.add_argument("--dry-run", action="store_true", help="Do not write files; print plan only")
+    args = p.parse_args(argv)
+    return Options(
+        input_dir=Path(args.input).resolve(),
+        output_dir=Path(args.output).resolve(),
+        daily_folder=args.daily_folder,
+        dry_run=bool(args.dry_run),
+        tasks_format=str(args.tasks_format),
+        field_keys=list(args.field_key or []),
+    )
+
+
+def main(argv: List[str]) -> int:
+    opt = parse_args(argv)
+    if not opt.input_dir.exists():
+        print(f"Input directory not found: {opt.input_dir}", file=sys.stderr)
+        return 1
+    opt.output_dir.mkdir(parents=True, exist_ok=True)
+
+    print("[START] Logseq → Obsidian conversion")
+    print(f"[CONFIG] input={opt.input_dir}")
+    print(f"[CONFIG] output={opt.output_dir}")
+    print(
+        f"[CONFIG] daily_folder={opt.daily_folder or '-'} tasks_format={opt.tasks_format} field_keys={','.join(opt.field_keys) or '-'} dry_run={opt.dry_run}"
+    )
+
+    plans = collect_files(opt)
+    total = len(plans)
+    md_total = sum(1 for p in plans if p.is_markdown)
+    other_total = total - md_total
+    print(f"[SCAN] Discovered {total} files ({md_total} markdown, {other_total} other)")
+
+    # First pass: read markdown files and pre-transform to attach ids, etc., to allow building index
+    pre_texts: Dict[Path, str] = {}
+    in_to_out: Dict[Path, Path] = {pl.in_path: pl.out_path for pl in plans}
+
+    warn_messages: List[str] = []
+    for pl in plans:
+        if not pl.is_markdown:
+            continue
+        try:
+            rel = pl.in_path.relative_to(opt.input_dir)
+        except ValueError:
+            rel = pl.in_path
+        print(f"[TRANSFORM] {rel}")
+        raw = pl.in_path.read_text(encoding="utf-8")
+        # Compute the expected title as the vault-relative output path without extension
+        try:
+            rel_out = pl.out_path.relative_to(opt.output_dir)
+        except ValueError:
+            rel_out = pl.out_path
+        expected_title = rel_out.with_suffix("").as_posix()
+        transformed = transform_markdown(
+            raw,
+            expected_title_path=expected_title,
+            rel_path_for_warn=rel,
+            warn_collector=warn_messages,
+            tasks_format=opt.tasks_format,
+        )
+        pre_texts[pl.in_path] = transformed
+
+    block_index = build_block_index(pre_texts)
+    print(f"[INDEX] Resolved {len(block_index)} block id(s)")
+
+    # Second pass: write files, replacing block refs using the index
+    writes = 0
+    copies = 0
+    for pl in plans:
+        if pl.is_markdown:
+            text = pre_texts.get(pl.in_path, pl.in_path.read_text(encoding="utf-8"))
+            text = replace_block_refs(text, block_index, in_to_out, opt.output_dir)
+            text = replace_embeds(text)
+            text = replace_wikilinks_to_dv_fields(text, opt.field_keys)
+            text = replace_asset_images(text)
+            # Ensure a trailing newline at EOF to match golden outputs
+            if not text.endswith("\n"):
+                text += "\n"
+            copy_or_write(pl.out_path, text, pl.in_path, opt.dry_run)
+            writes += 1
+        else:
+            # Copy assets and others
+            copy_or_write(pl.out_path, None, pl.in_path, opt.dry_run)
+            copies += 1
+
+    print(f"[DONE] Wrote {writes} markdown file(s), copied {copies} other file(s)")
+    if warn_messages:
+        print(f"[WARN] Conversion completed with {len(warn_messages)} warning(s). Review the messages above.")
+    if opt.dry_run:
+        print("[INFO] Dry run complete. No files were written.")
+    return 0