-
Notifications
You must be signed in to change notification settings - Fork 148
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
Suggestion for generated markdown header #69
Comments
Glad to hear you like the project! Yaml header format is not a part of common mark spec (which we are trying to follow), but it's widely used by different tools: It's always located at the top of the page. Without using it, user would need to pass such metadata (i.e. schema version) from command line. Although, C# part has this API, I didn't expose it via cmdlet. |
Interesting, I hadn't run in to it before and therefore hadn't realized it was more than just an informational header - thanks for that info. As to why I'm requesting, I am a poor soul who is only able to host my files here on github. My goal is to allow my project wikis to be my online documentation (tied in with my Get-Help My-Cmdlet -online target uri), one page per Cmdlet similar to what we'd see in TechNet. I'd like to provide my users a clean viewing experience, and since I doubt that any secondary tool will be processing these files I see no need to have the header in my wiki files. With that said, I realized that it must serve some purpose since it's there (and on) by default. So if it were optional I think it'd make sense to leave it on by default, but to have a SwitchParameter to allow it to be disabled for fringe cases like mine. Also, slightly off topic - if there was a promotional switch to add some kind of 'This document generated with PlatyPS' I'd use that too... |
I see, thank you! |
Hello! This tool looks great, and I plan to use this to help automate my github wiki very soon! However, I see in the newest version (from the repo, not from the PoSh Gallery) that the New-Markdown shows a header, even on your pages. For instance:
At the very least can this be moved to the bottom and/or become optional with a switch like you'd see with Export-Csv -NoTypeInformation?
I'm hip deep in things at the moment, but I can look in to making a pull request sometime this week if that would make things any faster.
Thanks for your consideration!
The text was updated successfully, but these errors were encountered: