Docs feedback - feature proposal: Allow importing PlantUML diagrams from .puml files into markdown files
Proposal
In a Markdown file (.md) I want to allow importing a PlantUML (.puml) file. This imagine this could look like such:
README.md:
- Consider the following Diagram:
```plantuml(../diagrams/myDiagram.puml)```
../diagrams/myDiagram.puml:
@startuml
Alice -> Bob: Authentication Request
Bob --> Alice: Authentication Response
Alice -> Bob: Another authentication Request
Alice <-- Bob: Another authentication Response
@enduml
The above example would now look like this:
README.md:
- Consider the following Diagram:
```plantuml
Alice -> Bob: Authentication Request
Bob --> Alice: Authentication Response
Alice -> Bob: Another authentication Request
Alice <-- Bob: Another authentication Response
\```
Whenever I want to edit this plantUML diagram I have to go into a new .puml file, copy&paste this part of the file, add @startuml and @enduml tags, do my changes + preview them locally, copy&paste it back into the .md file.
This is just one example way to manage it but overall it gets pretty annoying having to deal with this. Any method to work on this is very prone to user error.
Edited by Kamil Segebre