docs: fix multiline comments from proto files breaking tables (#1431)

* Add markdown.tmpl file for bufbuild

Signed-off-by: Cléo Rebert <[email protected]>

* fix typo

Signed-off-by: Cléo Rebert <[email protected]>

* docs: add issue reference

---------

Signed-off-by: Cléo Rebert <[email protected]>
Co-authored-by: Patrik <[email protected]>

Author: constantoine

buf.gen.yaml

@@ -24,5 +24,5 @@ plugins:
 
   - name: doc
     out: proto
-    opt: markdown,proto/buf.md
+    opt: proto/markdown.tmpl,proto/buf.md
     strategy: all