README.md files can easily contain PlantUML diagrams as it is still text.
It can be read by a human and could be rendered on bitbucket's projects' pages.

E.g.

@startuml
Bob->Alice : hello
@enduml