HNHacker News
TopNewBestAskShowJobs

gitpitch

102 karma · joined August 1, 2016

Freelance dev.

https://github.com/gitpitch https://github.com/onetapbeyond

submissionscomments
gitpitch··on Marp: Markdown Presentation Writer
If you want true separation between processor and "IDE" for your decks check out https://gitpitch.com - modern slide decks for developers on Git. Use your preferred editor - vi, emacs, atom, etc. to create your slide content.

The build pipeline is a simple git-push. Your slide deck is then instantly available for sharing online and for download as self-contained bundle or PDF.

A dedicated desktop tool is also available that gives you live previews and speaker support offline. You can also export your decks to Microsoft PowerPoint, Apple Keynote, and Google Slides.

For a sample GitPitch slide deck see here:

https://gitpitch.com/gitpitch/demo-deck

gitpitch··on GitPitch – Markdown Presentations for Devs on GitHub and GitLab
That looks very nice. Just fyi to anyone reading here it also worth mentioning that GitPitch has built-in support for graphs and charts powered by chartsjs.org.

See the GitPitch wiki here for details:

https://github.com/gitpitch/gitpitch/wiki/Chart-Slides

gitpitch··on GitPitch – Markdown Presentations for Devs on GitHub and GitLab
PITCHME.md is a convention. Simple and memorable just like README.md.
gitpitch··on GitPitch – Markdown Presentations for Devs on GitHub and GitLab
If you would like to have all of your "pitches" in a single repo you can absolute do that. As described in the Wiki:

"Sometimes you may find yourself wanting to build a series of related presentations within a single branch. Collectively these presentations may share common assets such as images, backgrounds, and even custom CSS styling."

For details see the following page in the GitPitch Wiki:

https://github.com/gitpitch/gitpitch/wiki/Asset-Sharing

You might also be interested in support for modular Markdown which allows you to share not just assets but Markdown snippets across multiple presentations. See here:

https://github.com/gitpitch/gitpitch/wiki/Modular-Markdown

gitpitch··on GitPitch – Markdown Presentations for Devs on GitHub and GitLab
Shoutout to reveal.js added to GitPitch README and Wiki. Credit already exists on the GitPitch.com website.
gitpitch··on GitPitch – Markdown Presentations for Devs on GitHub and GitLab
Great question. There is absolutely nothing wrong with reveal.js. In fact I like it so much I chose it as the underlying presentation rendering engine for GitPitch.

When you view a GitPitch presentation it is rendered by the reveal.js library. GitPitch simply provides a new way of delivering presentations that are powered by reveal.js that works seamlessly directly within GitHub, GitLab, or Bitbucket.

If you prefer to use the reveal.js library directly, or use their hosted service slides.com or any other of the great tools mentioned in this thread, then go right ahead. There is something for everyone. GitPitch offers it's own unique approach. And for some, that makes the most sense.

gitpitch··on GitPitch – Markdown Presentations for Devs on GitHub and GitLab
Sure. My apologies.
gitpitch··on GitPitch – Markdown Presentations for Devs on GitHub and GitLab
Hi @izacus it certainly does. The offline feature was designed for this very reason. With one click you get a fully self-contained bundle that downloads onto your computer. Just open it and follow the simple instructions given here in the Wiki:

https://github.com/gitpitch/gitpitch/wiki/Slideshow-Offline

gitpitch··on GitPitch – Markdown Presentations for Devs on GitHub and GitLab
Hi @tsumnia you can't use GitPitch to create animated graphics. There are lots of other tools for that. However you can use animated gifs within a GitPitch presentation, read about background images on the Image Slides page in the Wiki:

https://github.com/gitpitch/gitpitch/wiki/Image-Slides

Or if you have a series of images that combined present some kind of animation or workflow you can use those images as an animation sequence as described by Image Animation in the Wiki:

https://github.com/gitpitch/gitpitch/wiki/Image-Animations-W...

Here is a link to a sample presentation that makes use of this feature:

https://gitpitch.com/gitpitch/microservices-architecture

Do keep in mind, GitPitch is not trying to offer everything PowerPoint is capable of. Far from it. But it is trying to offer just enough, in a lot of use cases. But perhaps not yours.

gitpitch··on GitPitch – Markdown Presentations for Devs on GitHub and GitLab
Hi @alihcevik, GitPitch does not support private repos. However, if you want to keep your project code private but share the knowledge about your project using GitPitch then you can of course create a public repo just for your PITCHME.md presentation markdown.
gitpitch··on GitPitch – Markdown Presentations for Devs on GitHub and GitLab
Hi @autarch, thanks for the helpful feedback. I'll make some changes to the docs to make this clearer so existing users of reveal.js will immediately feel right at home. It's probably also worth noting that you don't need any knowledge of reveal.js to use GitPitch, just write some Markdown and then git-commit.
gitpitch··on GitPitch – Markdown Presentations for Devs on GitHub and GitLab
Hi @andrewguenther individual slides appear in the history by default as it allows direct linking inside a slideshow. See Slide Direct Links in the Wiki:

https://github.com/gitpitch/gitpitch/wiki/Slide-Direct-Links

If you want to disable this feature you can disable it using your PITCHME.yaml config file, just add:

history: false

gitpitch··on GitPitch – Markdown Presentations for Devs on GitHub and GitLab
Hi @xkr fair point. But to be clear, the hello-world example was written specifically to be embedded in the gitpitch.com website and it was designed to auto-play every slide so it could be watched almost like a short movie.

Typical presentations are something that the presenter manually steps through slide by slide as they speak. So needs none of fragment timing snippets you came across.

Almost any other GitPitch presentation out there is a better example of what's typically involved, for example, see this presentation from AnyCable:

https://gitpitch.com/anycable/anycable

gitpitch··on GitPitch – Markdown Presentations for Devs on GitHub and GitLab
Hi @orschiro you can include GitHub GIST within any GitPitch presentation, see the GIST Slides section in the GitPitch Wiki: https://github.com/gitpitch/gitpitch/wiki
gitpitch··on GitPitch – Markdown Presentations for Devs on GitHub and GitLab
Hi @MaxLeiter I tried to include BitBucket in the title text but was limited to 80 characters so it simply did not fit. Apologies for the omission here but it was beyond my control.
gitpitch··on GitPitch – Markdown Presentations for Devs on GitHub and GitLab
Hi @rorosaurus please see my reply on this thread where I explain that any GitPitch presentation can be downloaded as a fully self-contained bundle (HTML/CSS/JS) with just one click. And that gives you exactly what you need to deploy your presentation wherever you like.
gitpitch··on GitPitch – Markdown Presentations for Devs on GitHub and GitLab
Hi @mankash666, thanks for your feedback.

GitPitch was indeed launched with developers in mind. Devs often need to present and promote their work. Having worked as a software consultant for over 20 years I can attest to this. And with the rising popularity of tech meetups and conferences now more than ever making it easy to clearly present concepts, designs, etc. right alongside the actual code in your repo is a big win.

GitPitch is also seeing wide adoption across academia, particularly as a tool for delivering course materials, again right alongside the code.

As a final note, you mentioned a perceived drawback. GitPitch presentations are indeed automatically made available online just as soon as you git-commit and push to GitHub, GitLab or Bitbucket. But if you really want to host the presentation on your own domain or under your GitHub pages a fully self-contained bundle for your presentation is available for download with one click. You can then take the contents of that bundle (HTML/CSS/JS) and deploy it on your own Web server. No problem.