use syntax block with markdown and restructured text
The markdown output is quite suboptimal, you should use code blocks for the diff segments. That way you can add it verbatim into alot other systems
#### readelf --wide --notes {} (as it is)
@@ -1,8 +1,8 @@
Displaying notes found in: .note.gnu.property
Owner Data size Description
GNU 0x00000020 NT_GNU_PROPERTY_TYPE_0 Properties: x86 feature used: x86, x86 ISA used:
Displaying notes found in: .note.gnu.build-id
Owner Data size Description
+ GNU 0x00000014 NT_GNU_BUILD_ID (unique build ID bitstring) Build ID: 83f54a63ce2b3f39258987ce63fa2511a8085729
- GNU 0x00000014 NT_GNU_BUILD_ID (unique build ID bitstring) Build ID: 32adee5a53750cbf642b4041f2834d444324c6b7
#### readelf --wide --notes {} (as it should)
```diff
@@ -1,8 +1,8 @@
Displaying notes found in: .note.gnu.property
Owner Data size Description
GNU 0x00000020 NT_GNU_PROPERTY_TYPE_0 Properties: x86 feature used: x86, x86 ISA used:
Displaying notes found in: .note.gnu.build-id
Owner Data size Description
+ GNU 0x00000014 NT_GNU_BUILD_ID (unique build ID bitstring) Build ID: 83f54a63ce2b3f39258987ce63fa2511a8085729
- GNU 0x00000014 NT_GNU_BUILD_ID (unique build ID bitstring) Build ID: 32adee5a53750cbf642b4041f2834d444324c6b7
```
Same holds true for restructured text, should use .. code-block:: diff
, but I am not familiar with the correct block escaping rules.
Edited by Norbert Lange