Hello all!

I’m documenting a small FOSS project, and I’m looking for some soft that translates a documentation into a web page.

Something simple, with a side board that links the pages/titles/sub-titles, and is PC and Mobile compatible. Basically images, italics, bold and links, with titles and subtitles, would be nice 🙂.

Like the Lemmy install guide for example: https://join-lemmy.org/docs/administration/install_docker.html

Any recommendations?

Thank you all!

  • Ephera
    link
    fedilink
    212 days ago

    Hmm, I think, you can download one of the .tar.gz files from here: https://github.com/rust-lang/mdBook/releases
    Unpack it and then just run the executable that’s inside.

    And yes, images are absolutely possible.
    You can just place the image file in the file structure and then in your Markdown file, you can use this syntax:

    ![Optional description for sight-impaired users](relative/path/to/image.png)
    

    I usually create an “images” sub-folder next to the Markdown file, then it’s just:

    ![](images/something.png)
    
    • @ValmondOP
      link
      212 days ago

      Very nice, will definitely check out!

      Seems like exactly what I’m looking for.

    • @ValmondOP
      link
      211 days ago

      Update, works wonders thank you so much! 💖