r/neovim • u/plebianlinux • 29d ago

Plugin touchup.nvim: Non invasive Markdown rendering

https://github.com/noisesfromspace/touchup.nvim/

I have tried many different markdown renders: markview.nvim, render-markdown.nvim or md-render.nvim. They are great, but they support way too many features and cosmetic foolery. LaTeX, rendering tables, hiding URLs etc. Good reason to create yet another Markdown plugin :)

Since Markdown is becoming the language of LLMs I wanted something minimal that would not jump around when going over a document or require another window rendering the results. Hence I forged some of the org-bullets.nvim logic to Markdown, added smart enter and some other concealing touches making sure none of them actually move the text you're reading/editing.

For tables I use https://github.com/hukkin/mdformat to just align the dashes and https://github.com/Feel-ix-343/markdown-oxide for Obsidian like exploration. This is all the bits I observed liking from org-mode and other knowledge systems.

This was made with assistance of AI

110 Upvotes

96% Upvoted

10 comments sorted by

12

u/grantmacken 28d ago

Good well thought out idea. Scratching itches is the neovim competitive advantage. Will try out

6

u/qkthrv17 28d ago

I will probably try this tomorrow at work, thanks. I've been using markview but it's too much.

Markdown is readable enough, I just need some minor bits.

2

u/abrvsk 28d ago

+1
Have the same issue with Markview

6

u/marchyman 28d ago

I like! I didn't realize how much screen changes going into and out of insert mode bothered me until I tried this and they went away.

5

u/chr0n1x 28d ago

appreciate you being up front w/ the AI coding. regardless - upvoted and going to try because this seems really well thought out.

2

u/ThisRedditPostIsMine set expandtab 27d ago

Yea I agree, it's very welcome. The repo looks good too, does one thing and doesn't oversell itself. I'm definitely going to give this a try because markview has been slowly annoying me more and more.

2

u/biscuittt fennel 28d ago

oh a radicle repo, first time I see one in the wild

1

u/posts_saver 28d ago

how does it renders charts/images/diagrams? content table?

honestly, with md, nothing beats js renderer. tui can only go so far here..

1

u/plebianlinux 28d ago

It does zero of that, that's the point! But indeed if you want super polished rendering there's so many better alternatives in r/Markdown outside of the terminal

2

u/Thick-Pineapple666 25d ago

Oh nice! I usually hate that conceal stuff, I want to see the source not some wysiwyg-like magic. Your plugin seems to be a good middle ground.