My complete Neovim markdown setup and workflow in 2024

[@linkarzu]

What's your favorite tip and plugin from the video? Let me know down here in the comments

[@mambodogg]

Looks fabulously fantastic 😱

[@linkarzu]

I really like it too! Hope you find tips and inspiration for your own setup

[@farzadmf]

SO GOOD and mind-blowing!!! Great job!

[@linkarzu]

Glad you liked it, thank you. I hope you find good tips and tricks in the video!

[@farzadmf]

I did, but definitely one of those videos that I need to go back to multiple times to use some ideas. Thank you for having a blog post as well, since text search is much easier than watching a video trying to find what you need Keep up the GREAT work!

[@linkarzu]

I get how you feel, that's the exact reason I have the blog post. Even though is more convenient for me not to have it because of the views 🤣 But I'll keep creating blog posts as they help me remember stuff as well

[@farzadmf]

That's super nice of you! As I said, you're doing great, keep it up!

[@linkarzu]

@farzadmf appreciate it!

[@iyar220]

Incredible. Haven't watched yet but surely this will improve my obsidian note taking from within neovim! So far i just used obsidian with vim bindings

[@linkarzu]

@@iyar220 I haven't opened Obsidian in like 3 months, so I'm pretty sure this is targetted for us Obsidian users. Hope you find it useful!

[@iyar220]

​@@linkarzu This was amazing! My favourite things that I'm going to apply are: headlines.nvim Outline.nvim markdown-preview.nvim Image.nvim img-clip.nvim Snippets Go to file with gd using markdown lsp Now the only reason I'll have to enter obsidian is for the node graph view.... Unless?!?!?

[@iyar220]

P.S. subscribed!

[@linkarzu]

@@iyar220glad you found some useful tips! I think obsidian's graph view is overrated, do you really find a use case for it? And recently I switched from headlines.nvim to MeanderingProgrammer/render-markdown.nvim, love it, just have a small bug with folds, but opened an issue in the repo already, we'll see

[@iyar220]

@@linkarzu Thanks for saying! I'll definitely check it out. As for Obsidian's graph view: Yes it's very useful for me. You see, I use Obsidian as my self study tool. So whenever i learn something new or want to learn something new, i create a new file / reference a file with [[]]. The graph view, then, becomes a study map, illustrating which topics (files) are related to which. It also serves as a topic-segregated todo list, since files that aren't yet made are toggled gray.

[@hechuan5075]

the point on null-ls is. really good, i spent a few hours looking into how to get dianostics from markdownlint and tried efm then came upon null-ls. Great informative video, but I'd highly recommend separating this video into few parts. Its really hard to follow through thorougly

[@linkarzu]

Yeah, there's a lot information condensed in this single video. But I'm creating separate videos to go over things in a slower way, I recently created one for folds, and one for the daily note. Will keep creating others and maybe next year create another one explaining what changed between this 2024 video and that new one

[@hechuan5075]

@@linkarzu awesome, great work sir!

[@linkarzu]

Appreciate it!

[@adriansrfr]

You might like harpoon better than marks since marks are global and thereby be noisy between projects where you might not want to see those marks.

[@linkarzu]

Prime fan here 🤝 I installed harpoon, but I haven't still found a way to introduce it into my workflow, haven't found a use case, but i've not put much thought into it to be honest. I will take the time some day, and hopefully share it in a video

[@FekuEntertainmentLtd]

Thanks a lot for the timestamps. I use obsidian but still think our setup matches around 40%. Obsidian because I use mermaid. My rest of the setup is mostly specific to personal liking. Some of the things mentioned here are already what I do, so the timestamps made it easy to check for new configs/setups like spell check, some snippets and keymaps.

[@linkarzu]

I'm glad you found some useful things, and I agree, my setup is also specific to personal liking, and I feel it improves my markdown editing experience quite a bit, specially coming from obsidian.

[@wickjohn3854]

excellent sharing :)

[@wickjohn3854]

the biggest advantage of using obsidian.nvim i think is backlink, btw i just just use navbuddy as TOC LOL

[@linkarzu]

First comment! Thank you, hope you learn a couple things from it.

[@linkarzu]

I hadn't seen your recommendation, thanks for the navbuddy tip, I'll check it out. I just use the TOC for my blog post and if I need to print a markdown file as PDF, so people can navigate the headings, but I don't use it inside Neovim

[@codelistic]

Such a great video condensed with so much valuable info. No fluff! I love it. I have a question regarding wrapping. With your setup I guess you "hard-wrap" lines on 80 characters, right ? Which means essentially LF characters are inserted within the paragraphs at the end of each line. I know that's required for prose/text to look nice in Neovim, but if you were to now copy-paste the markdown content to some other editors you would end up with line feeds there as well. Or if you wanted to publish the markdown directly in a blog post you would still get them there... This would make the text always hard-wrap in all editors and all screen sizes which is sometimes an issue of itself. Since I have a similar dilemma for my markdown files, I'm curious how do you get around this problem? Or do you have some kind of utility or plugin that reformats the paragraphs back into a "one long line" instead... ? Curious to hear your thoughts. Thanks and keep up the great work!

[@linkarzu]

@@codelistic appreciate the comment! That's a great point, the file you see me editing in the video is my blogpost, and I don't have any issues there. However, if I edit something in neovim and paste it in one of my video descriptions, I notice the behaviour you're describing, but it doesn't bother me enough to take any action, so I haven't checked how to fix it. Let me know if you come up with a solution, as now I'm curious

[@kernelpanic_init1]

Wallpaper looks cool. (Just started watching)

[@linkarzu]

Let me know if you found some useful tips!

[@_Roman_V_Code]

Hey! which font you're using for terminal? I'm using "FiraMono Nerd Font Propo", nerd version too, but I had issues with headlines plugin (as it was not rendered properly, so I disabled it)

[@linkarzu]

Hey there, nice to see you here 😍 I'm using "font-meslo-lg-nerd-font", in macOS brew install --cask font-meslo-lg-nerd-font

[@_Roman_V_Code]

@@linkarzu thanks! I will try to use it :)

[@linkarzu]

@@_Roman_V_Code Yeah, that should work, let me know

[@_Roman_V_Code]

@@linkarzu tested headlines plugin, it works. thanks :)

[@linkarzu]

Wonderful!

[@devstefancho]

15:11 how to apply different background color of code block in markdown file? what plugin do you use for this?

[@linkarzu]

Look at my headlines.lua file

[@flameKuchen]

Awesome. Mini surround and MD preview are nice. How did you integrate those custom keybindings in the telescope keymap view?

[@linkarzu]

Mini surround is a beauty. Which key bindings, the ones for the todo items?

[@flameKuchen]

yeah those for folding. By the way I didn’t know you can show images in neovim on Mac 😱😊

[@linkarzu]

Yeah, not only view, but paste images in different formats, it's wonderful. Please point me to the part of the video you're referring to about the folds, like what minute and second because I'm not following

[@flameKuchen]

@@linkarzu26:10 your customer key bindings in telescope preview

[@linkarzu]

Oh, I see what you mean, when I press sk how do I show all my keymaps? It's a builtin telescope function, if you have telescope installed, just run :Telescope keymaps I use the lazyvim.org distro, so Folke adds this keymap by default, so I didn't do anything. Hope that answers the question, let me know.

[@killua_148]

Hi. Thank you very much for showing how to disable some warnings with markdownlint-cli2. Do you happen to know if there's a way to do it globally instead of per directory? Also, do you know if there's a way to make markdownlint-cli2 work in "realtime"? I mean update its warnings without having to save first. It does work for you because you use autosave plugin, but I'd like to avoid that.

[@killua_148]

Couldn't solve the second issue. For the first one, I found the answer on LazyVim discussion #4094, I don't link because YT removes the comment I think you can fix the second issue by using "--stdin" option, which only works on markdownlint-cli (non cli2)

[@linkarzu]

Wonderful! Let me test out the discussion you mentioned for issue # 1 I agree, it's pretty annoying to be putting that file in multiple directories, even if it's a symlink. And yes, KZbin deletes the comments if you put the link, but I think it allows me to add it, let's give it a try: github.com/LazyVim/LazyVim/discussions/4094 Now regarding the "real-time" part, to be honest, I'm not sure, I'm used to auto-save now so I'm not switching back, the good thing is that I can disable auto-save in files that I don't want it, like .sql or other ones. But if you're able to figure it out, share it here in case others have the same question

[@linkarzu]

​@@killua_148 I just tried out your suggestion for the markdownlint-cli2 plugin and it's working wonderfully, I really appreciate it. The good thing is that if you want to override the settings for a specific directory, you still add it the old way (the way I did it) and that file will take precedence Thank you!!!

[@killua_148]

@@linkarzu Happy to be helpful. You really helped me with markdown/images configuration in neovim

[@linkarzu]

@@killua_148 I'm glad you got some helpful tips. That's the goal, to help each other out!

[@Chat_De_Ratatoing]

hey how did you add your custom snippets to luasnip ?

[@linkarzu]

Do you use the LazyVim.org distro, another one or your own built setup?

[@borkesahin8729]

is it possible to do this similar config on Windows Terminal with Neovim?

[@linkarzu]

@@borkesahin8729 I think windows folks use WSL and install the Kitty terminal app in WSL, so neovim will be basically running in Linux and not Windows.

[@borkesahin8729]

@@linkarzu thank you but may I ask why Windows Terminal can't do same as Kitty ?

[@linkarzu]

@@borkesahin8729 I don't use Windows, so I have no idea to be honest, but even if I was forced to use Windows, I'd run everything under Linux, using WSL. I dont think you can install tmux on the windows terminal, or view images the same you can in kitty.

[@jcionx]

What desktop environment are you using?

[@linkarzu]

Hey, you mean which OS or which linux desktop environment?

[@jcionx]

@@linkarzu It looks like you're using macOS. And I would like to make my macOS look like that desktop environment you've got.

[@jcionx]

​@@linkarzu Is it like a replacement for the macOS bar, or is it something different

[@linkarzu]

😉 You're right, it's macOS. I have a video series in which I explain how to set everything up. The menu bar that you see on the top is Sketchybar, I have a video about that, you can find it here: Install and configure a custom menubar, sketchybar macOS kzbin.info/www/bejne/eYqTmIiVnrWFis0 Give me a minute, I'm updating my blog post to point to my latest config files and I'll let you know what you have to do to get everything setup.

[@linkarzu]

The blog post is updated, I go over my macOS workflow and setup in this playlist. It's my first videos, so the quality is not the best, but the content is still relevant kzbin.info/aero/PLZWMav2s1MZTanWwNKYvS8qgwl0HBH9J-&si=vMd8rAUIg9YpHdnV

[@muizzyranking]

Your dots?

[@linkarzu]

I forgot to add them in the video description, you can also find them in the blogpost. But here they are: github.com/linkarzu/dotfiles-latest

[@juanandresnunez658]

I am trying to use marksman to visualize my obsidian notes (after trying to use obsidian.nvim). It has been hell so far. What does "Ambiguous link to document" mean?

[@linkarzu]

When you see that error, what happens when you press "gd" (go to definition) on top of that link?

[@juanandresnunez658]

@@linkarzu Opens a small window in the bottom named "Quickfix list" showing the headers of the file. This makes me feel like when I do [[]] I need to specify the file and a header to link (haven't tested as I write this comment). Not to mention this little window is kind of annoying as I can only close it by :q inside it.

[@linkarzu]

In my specific case, when I see that error, it means that I have 2 markdown files with the same name, so marksman doesn't know which file to go to when I press "gd". Renaming one of the files solves the issue for me. See the example below, I use the lazyvim distro, and when I press "gd" it calls the "nvim-lspconfig" plugin, which in turn opens telescope so that I can chose 1 of the 2 files to open sharing.linkarzu.com/JDn5BCbKNfhGDfpgxpVV So my guess is, you probably have 2 files with the same name

[@juanandresnunez658]

@@linkarzu I def don´t have duplicate files with the same name. I actually am testing on a considerably small Vault of less than 30 files (I'm a newbie taking notes). Still I will try to look into it. Thanks for the help!

[@linkarzu]

No worries, let me know if you're able to figure it out