command-line-parser

I know it's really an edge case since it can only happen when not reading the awesome documentation properly.

But since it's actually a contradiction according to the documentation and other similar things are also throwing an error, you might want to consider checking for this case and throwing an INVALID_DEFINITIONS error?

Alternatively it would make sense to just document which one wins,

I guess there is no real consistent scheme, but quite a few tools capitalize the help section headers.
So maybe a flag could be added to do the same when using kotlin-argparser.

So showiing

Usage: [-h] [-a] IMAGE-DIRECTORY MARKDOWN-FILES...

Optional arguments:
  -h, --help        show this help message and exit

  -a, --auto        Automatically remove orphan images


Position

package main

import (
	"fmt"
	"github.com/akamensky/argparse"
	"os"
)

func main() {
   parser := argparse.NewParser("accounts", "Prints provided string to stdout")
   noTest := parser.Flag("n", "no-test", &argparse.Options{Help: "boolean true/false", Default: true})

   err := parser.Parse(os.Args)
   if err != nil {
      fmt.Print(parser.Usage(err))
   }
   fmt.Println(*no