Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Markdown formatting for documentation #32

Open
ad-m opened this issue Jul 7, 2020 · 4 comments
Open

Markdown formatting for documentation #32

ad-m opened this issue Jul 7, 2020 · 4 comments

Comments

@ad-m
Copy link

ad-m commented Jul 7, 2020

Hello,

Thank you for the very helpful library. I see her new use case. Well, I'm going to develop documentation using the Markdown format for our extensive CLI.

To this end, support for Markdown formatting would be useful.

I am asking for information in this regard, as well as in the scope of possible incorporation of changes to this library. I prefer to be sure about work on the topic before I start developing my own solution.

Kind regards,

@75lb
Copy link
Owner

75lb commented Jul 7, 2020

You can see an example of how I format the output for markdown here (click "edit" to see the raw markdown):
https://github.com/lwsjs/local-web-server/wiki/CLI-usage

Does that help?

@ad-m
Copy link
Author

ad-m commented Jul 7, 2020

Thank you for the quick reply.

This is the initial approach (I have used it before for testing CLI generator) and it is enough for internal needs to use code syntax. However, my goal is to develop Markdown documents that can then be turned into a full-fledged page (using VuePress / Hugo or another static page generator) like https://cloud.google.com/sdk/gcloud/reference or https://docs.aws.amazon.com/cli/latest/reference/#available-services .

In this case, it needs a more markdown-way generation method. As I understand it, there are no ongoing works in this respect and I will have to think about how to approach them myself.

@ad-m
Copy link
Author

ad-m commented Jul 8, 2020

command-line-application already implemenent Markdown formatting: https://github.com/hipstersmoothie/command-line-docs

@75lb
Copy link
Owner

75lb commented Sep 2, 2021

Have you made an progress with this issue? I don't have any immediate plans to build a markdown generator for CLI documentation, but maybe in the future..

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants