Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/go-kiss/protoc-gen-markdown
markdown doc generator for protobuf
https://github.com/go-kiss/protoc-gen-markdown
grpc markdown protobuf twirp
Last synced: about 1 month ago
JSON representation
markdown doc generator for protobuf
- Host: GitHub
- URL: https://github.com/go-kiss/protoc-gen-markdown
- Owner: go-kiss
- License: mit
- Created: 2018-12-16T08:15:39.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-03-13T21:28:38.000Z (8 months ago)
- Last Synced: 2024-09-30T15:41:27.463Z (about 1 month ago)
- Topics: grpc, markdown, protobuf, twirp
- Language: Go
- Homepage:
- Size: 34.2 KB
- Stars: 66
- Watchers: 3
- Forks: 10
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# protoc-gen-markdown
## install
```bash
go install github.com/go-kiss/protoc-gen-markdown
```
## generate markdown
```bash
protoc --markdown_out=Mhello.proto=./:. ./hello.proto
# set path prefix to /api
protoc --markdown_out=Mhello.proto=./,prefix=/api:. ./hello.proto
```
## demo
You could check the [hello.md](hello.md) to see the result.
## doc
I have write a [Chinese article](https://taoshu.in/go/create-protoc-plugin.html) to introduce how it works.