Hello Everyone,

i’d like to ask for your opinion on the following issue:

i’ve created my own knowledge base based on asciidoc, with some custom shell scripts and a go application for creating backlinks, tags etc. I’ve chosen this way, as most solitions are based on markdown, which is not standarized and very limited compared to asciidoc, especially from a dev pov.

All my editing, searching etc. is done via neovim, which is very comfortable.

However, i’d like to improve the user experience with the setup, as i’d also like to see the rendered version, especially when adding mermaid diagrams and other things.

I’ve tried some plugins for the browser, which render the view and update automatically, however they are not in sync with my nvim, so i have to scroll on every save, if i want to see the rendered version. That’s not ideal.

Any ideas?

Ideally I’d like some kind of application template, where i can embed a terminal / neovim and a webbrowser, ideally linked via lua scripting, so it integrates nicely. It can also be a completely separate application like anytype, however i’ve not seen anything that has a proper vim-like module editing support & allows for asciidoc rendering instead of markdown.

  • 𝘋𝘪𝘳𝘬@lemmy.ml
    link
    fedilink
    arrow-up
    1
    ·
    9 months ago

    Any ideas?

    Pandoc allows conversion from and to various formats. You could use an autocmd to generate a rendered version of your document and access this version with your web browser. In your browser you could use an extension that automatically refreshes a tab every x seconds.

    Would be a very manual and not-so-elegant variant, but hey :)

    • TheWanderer@lemmy.mlOP
      link
      fedilink
      arrow-up
      1
      ·
      9 months ago

      The conversion is not an issue, there are already multiple tools for that, including a browser plugin with auto refresh.

      However the tight integration with the editor, in this case neovim, is missing. At the bare minimum it should show the changed area curently being edited, ideally scroll with the editor scrolling like with common markdown extensions. Currently it just shows a static site that refreshs.

  • humdrumgentleman@lemmy.world
    link
    fedilink
    arrow-up
    1
    ·
    9 months ago

    Prescript: I am by no means a programmer, and input to follow is likely useless.

    Have you looked at Markdown plugins that otherwise align with what you are looking for to see if there are usable approaches to be adopted? Or maybe even contribute a PR to one of those projects for Asciioc support?

    In any case, I recently fell in love with Asciioc and selfishly hope you are successful!

    • TheWanderer@lemmy.mlOP
      link
      fedilink
      arrow-up
      2
      ·
      9 months ago

      I had a similar idea, however i haven’t seen a markdown plugin, that is well maintained and at the same time simple enough, so that the core, in this case markdown, can easily be replaced with a completely different engine, asciidoctor.

      Any recommendations for that?

      I also thought about changing neorg, but the missing support for treesitter is a k.o. for asciidoc.