hack to migrate from obsidian / converting all filenames without breaking links

[tjex]

Hello all.

I've landed here after a fairly thorough search of pure neovim/terminal solutions for a pkm / wiki and super, super happy to be here. I'm really impressed and excited with zk's features, robustness, design and accessibility / interoperability.

Thanks so much for making this @mickael-menu 🙏

So I'm facing the task of transferring my entire obsidian vault to zk.
I really hate having spaces in the file names, which I think is unavoidable in Obsidian unless they've introduced a feature like zk / vimwiki, where links have spaces for readability, but filenames have delimiters.

I looked for a zk link converter / batch renamer command, but didn't find any. Please point me there if I missed it.

In any case, wanted to explain how I'm getting around this in the meantime.

So the initial state of my obsidian syntax is: [[wikilinks with spaces]] and file names with spaces.md.

To change to [[wiki links with spaces]] but file-names-with-hyphens.md we can do the following:

1. make a new root directory, thenzkm init
2. select either prefer [[wikilinks]] or not (doesn't matter, also awesome)
3. edit .zk/config.toml -> filename = "{{slug title}}"
4. batch rename all the files in the obsidian vault to include the delimiter you want. This needs to be done before copying the files to the zk notebook. Do this on a copy of the obsidian vault of course...
5. move the renamed files / vault into the zk notebook
6. run zk index

Now all the wikilinks in notes maintain legibility by having spaces and link to their respective markdown files, which have your chosen delimiter.

Note step 4: It will also not work if you copy the files into a folder and run zk init in the folder. This is because zk will index and create entries in the sql database of [[wikilinkk]] -> file. Renaming the files after that will break the wikilinks.

Well, they will still actually work with go to definition (at least for me, but that may be the case of having marksman lsp), but I still get lsp errors saying the note doesn't exist (thats a nish nish).

Also, if people need, a good renamer I've found is rnm.