I started switching from markdown to asciidoc for my code project documentation, and it was much easier than I expected. For simple docs it's almost exactly like Markdown, and its IntelliJ plugin is better, too.