Markdown Presentations for Tech Conferences, Training, Developer Advocates, and Educators.

Overview

March 1, 2021: Service on gitpitch.com has been shutdown permanently.

GitPitch 4.0

About

GitPitch 4.0 is the perfect slide deck solution for tech conferences, training, developer advocates, and educators. Available on MacOS, Linux, and Windows 10. Work and present offline. Export to PDF, PPTX, and HTML. Or git-push to share public, private and password-protected slide decks online.

GITPITCH


  • GitPitch is a markdown presentation tool for MacOS, Linux, and Windows 10.
  • GitPitch Desktop lets you develop, preview, and present markdown presentations offline.
  • Using modular markdown to deliver modular decks.
  • Export your markdown presentations to PDF, PPTX, and HTML.
  • And publish and share your markdown presentations online.
  • To publish any deck just git-push to any repo on GitHub, GitLab, or Bitbucket.
  • And share it as a public, private, or password-protected slide deck.

GitPitch Documentation

The official GitPitch docs are maintained in this repository under the docs directory. Pull-requests on this repo to fix or improve the documentation in any way are very welcome. You can view the documentation live at https://gitpitch.github.io/gitpitch.


GitPitch Product Repos

GitPitch began as an open-source project back in 2016. Since early 2017 I have been working full time developing a number of GitPitch products and services most of which are maintained in private repositories.

This repository is now used to maintain the official GitPitch docs. You can also use this repository to report issues and request features for all GitPitch products using GitHub issue tracking.

Comments
  • Elements overflowing slide

    Elements overflowing slide

    I've encountered problems with elements, such as vertical images and tables, going through the lower limits of the slide and, therefor, being imposible to be seen in any way. Worst thing is, when I try to print the pitch as PDF, those elements that were invisible at the slide now overflow the next one.

    I see two solutions:

    • Code snippets handle overflow in a nice way, allowing you to scroll both vertical and horizontaly; maybe you could make this the default behaviour when contents are bigger than slide, or include a special syntax to force that.
    • Markdown doesn't provide tools itself to handle size of images (AFAIK and not including HTML), so it would be nice to automatically resize elements so they can fit inside the slide, or include a special syntax to force that.
    opened by miguescri 32
  • Is it possible to hide the menu by default?

    Is it possible to hide the menu by default?

    When I open my slides, it defaults to the presentation and the input handlers default to navigating through the menu rather than the content.

    https://gitpitch.com/samuelgoto/proposal-block-params

    Is there any way to hide the menu by default?

    opened by samuelgoto 19
  • Configuring gitpitch on ubuntu

    Configuring gitpitch on ubuntu

    Hi, After configuring and starting the application, when i browse to my server http://localhost:9000, it gives me a messageBad Request, Host not allowed error. my application logs says ,successfully started and listening on /0:0:0:0:0:0:0:0:9000.

    After making build, i have done following changes

    1. Changed Secret Key
    2. Made gitlab as my default and set the API key.

    Both gitlab and gitpitch is running on same ubuntu machine

    Am i missed any steps?

    opened by pmsudhi 19
  • Add code revealing

    Add code revealing

    I would like to see a feature that would allow me to write one code snippet and reveal more and more of its lines.

    To achieve that right now I have to write multiple code snippets with duplicate code, for example: https://github.com/EvgenyOrekhov/talks/blob/master/why-so-functional/PITCHME.md#v20.

    enhancement 
    opened by EvgenyOrekhov 18
  • Support for branches with odd characters in names

    Support for branches with odd characters in names

    We have begun evaluation of gitpitch internally in our gitlab-based organization and this has our engineers/management quite enthused. :)

    A bit of a blocker for adoption is that our org. uses gitflow and branch names have slashes in them of the form feature/foo or bugfix/bar, etc which gitpitch does not seem to work with.

    e.g.

    https://gitpitch.com/user/repo/branch          # works
    https://gitpitch.com/user/repo/feature/branch  # does not
    

    Please would you add support for these?

    opened by shalomb 16
  • No alt text on images

    No alt text on images

    I expected that the information I was adding into an image was being implemented as alt text. Alas, it is not. The information is being added as the title attribute - this is incorrect! The title attribute only helps mouse users. Any description of the image should be added onto the <img> element in the alt attribute. This is a serious accessibility issue.

    There should also be a way to indicate that the image is decorative and does not need a description. If I enter then an empty alt attribute should be inserted. This can be accomplished via <img src="thesource" alt> or &ltimg src="thesource" alt="">

    This is a serious accessibility issue.

    opened by becka11y 14
  • GitPitch 4.0 - deprecated syntax ->

    GitPitch 4.0 - deprecated syntax -> "Upgrade Guide" link is broken

    Describe the bug The link describing deprecated syntax / "upgrade guide" is broken : https://docs.gitpitch.com/#/upgrading-to-40

    --> Page Not Found

    To Reproduce Try opening "https://gitpitch.com/markustiede/about/master?p=slides/intro" -> click "GitPitch 4.0 Upgrade Guide" link

    Expected behavior Clear migration path is shown.

    Browser (please complete the following information):

    • Safari

    Operating System (please complete the following information):

    • MacOS

    Additional context It's quite sad that (IMHO) instantly all of my presentations broke (due to unknown / unclear reasons); without being able to fix them.

    opened by MarkusTiede 13
  • Images not showing in offline mode

    Images not showing in offline mode

    When I add an image to a slide, I am using: ![Logo](images/opensource_logo.png)

    Which works when viewing online. But when I download and attempt to view it locally python -m http.server

    It displays the alt-text (in this case "Logo") instead of the image. It's trying to pull it from http://localhost:8000/assets/opensource_logo.png which in the offline.zip is relative to the pitchme.md file in the /md/assets/ folder and the file is there... All very strange

    opened by jerdog 13
  • Image Not Rendered in PDF

    Image Not Rendered in PDF

    I cannot get images to render when using the 'print' function on an internal instance of GitPitch.

    I am running my own instance of GitPitch connected to an internal GitLab instance. Everything works well until I try to print / save-to-pdf. I have a single slide that contains an image ( png referenced by a local path to the related repository ). When I view the presentation through GitPitch, the image shows up as expected. When I try to print it to pdf, everything gets saved out except the image gets replaced by the question mark placeholder. The server does not indicate that anything encountered any issues. I have put the image both as an embedded image and used it as a logo through yaml and have encountered the problem in either case

    opened by tjc1575 12
  • List markup not working as expected within @snap

    List markup not working as expected within @snap

    The following markup works on its own, i.e. gives a nice bulleted list:

    ### Test pitch
    
    * one
    * to
    * three
    
    - four
    - five
    - six
    

    However, if it is wrapped in @snap and @endsnap the list items aren't understood as such, they are just displayed as normal text with * interpreted as italic, see image below

    Screenshot 2019-08-08 at 00 31 23
    opened by hallvard 11
  • Remote images not showing in PDF

    Remote images not showing in PDF

    I seem to be having issues displaying remote images when printing a presentation out to PDF.

    All the images for the presentation are hosted on Dropbox (linked to with urls that have the form of https://www.dropbox.com/s/xxxxx/image.png?dl=1), and they display inline as expected when viewing the presentation on GitPitch, but when printed to PDF, all I see are broken image icons.

    Details about the presentation are here:

    Here is an example screenshot of what I'm seeing when I print to PDF:

    images-missing

    Since "remote images are supported by GitPitch both within slides and when printing to PDF", what should I be doing to get them displaying properly?

    opened by paulfioravanti 11
  • Gitpitch and latest open source version clarification

    Gitpitch and latest open source version clarification

    David, it's sad to see Gitpitch shutting down.

    For those interested in continuing the open source version of GitPitch, could you clarify which would be the latest version available with an MIT license?

    As per the repo history, it seems commit e45b14e, the one before versión 4, was the latest to include the 2017 source code with an MIT license.

    Thanks.

    opened by facundoq 0
  • Dockerfile

    Dockerfile

    Hi,

    I have been a paying customer on docker, and still need the desktop image for new development.

    I understand that you discontinue the project, but please, is it possible to release all source so that we can at least keep on?

    Thank you

    opened by jpic 0
  • Disable ToC Auto-generation

    Disable ToC Auto-generation

    When Table of Contents is enabled it auto generates links for all the slides in the deck. This can look unorganized when building decks with a substantial number of slides.

    It would be great for ToC to only link to chapters/modules and not individual slides. For instance, only slides annotated with @toc are shown in the ToC.

    opened by ahmedgabers 0
  • highlight js not supporting terraform in update

    highlight js not supporting terraform in update

    Terraform does not seem to be supported in the latest version of highlight that you have in gitpitch. Is there a way to add custom language files or a PR process to request them?

    enhancement 
    opened by smwilson1230 3
Owner
David Russell
Developer of gitpitch.com - Slide Decks for Developers.
David Russell
A minimal platform for Markdown-based blogs

madblog This project provides a minimal blogging platform based on Markdown files. Demos This project powers the following blogs: Platypush My persona

Fabio Manganiello 2 Aug 02, 2022
a small simple library for generating documentation from docstrings

inkpot a small simple library for generating documentation from docstrings inkpot is available on pip. Please give it a star if you like it! To know m

Axel Gard 5 Oct 20, 2022
Convert HTML to Markdown-formatted text.

html2text html2text is a Python script that converts a page of HTML into clean, easy-to-read plain ASCII text. Better yet, that ASCII also happens to

Alireza Savand 1.3k Dec 31, 2022
CiteURL is an extensible tool that parses legal citations and makes links to websites where you can read the cited language for free.

CiteURL is an extensible tool that parses legal citations and makes links to websites where you can read the cited language for free. It can be used t

15 Dec 27, 2022
Awesome Django Markdown Editor, supported for Bootstrap & Semantic-UI

martor Martor is a Markdown Editor plugin for Django, supported for Bootstrap & Semantic-UI. Features Live Preview Integrated with Ace Editor Supporte

659 Jan 04, 2023
WyPyPlus is a minimal wiki in 42 lines of Python code.

🍦 WyPyPlus: A personal wiki in 42 lines of code 🍦 WyPyPlus (pronounced "whippy plus") is a minimalist wiki server in 42 lines of code based on wypy

Leo Chen 8 Apr 07, 2022
A Python library to retrieve annotations and notes from Zotero and save them into Markdown files.

Zotero to Markdown Generate Markdown files from Zotero annotations and notes. With new Zotero PDF Reader, all highlights are saved in the Zotero datab

Essi Alizadeh 20 Nov 03, 2022
Converts a grading Excel sheet into Markdown documents.

GradeDocs Turns Excel worksheets into grade/score documents. Example Given such an Excel Worksheet (see examples/example.xlsx): The following commands

Patrick Bucher 1 Dec 19, 2021
A fast, extensible and spec-compliant Markdown parser in pure Python.

mistletoe mistletoe is a Markdown parser in pure Python, designed to be fast, spec-compliant and fully customizable. Apart from being the fastest Comm

Mi Yu 546 Jan 01, 2023
Convert mind maps to markdown for import into Roam.

Mind Map to Markdown for Roam import Got a Mind Map with contents you'd like to import into Roam? Soon, this Python application might do what just you

Romilly Cocking 3 Dec 09, 2021
Provides syntax for Python-Markdown which allows for the inclusion of the contents of other Markdown documents.

Markdown-Include This is an extension to Python-Markdown which provides an "include" function, similar to that found in LaTeX (and also the C pre-proc

Chris MacMackin 85 Dec 30, 2022
A markdown lexer and parser which gives the programmer atomic control over markdown parsing to html.

A markdown lexer and parser which gives the programmer atomic control over markdown parsing to html.

stonepresto 4 Aug 13, 2022
A markdown template manager for writing API docs in python.

DocsGen-py A markdown template manager for writing API docs in python. Contents Usage API Reference Usage You can install the latest commit of this re

Ethan Evans 1 May 10, 2022
Notedown - Markdown <=> IPython Notebook

Python 2/3 and IPython 4 / Jupyter compatible! Convert IPython Notebooks to markdown (and back) notedown is a simple tool to create IPython notebooks

Aaron O'Leary 840 Jan 04, 2023
markdown2: A fast and complete implementation of Markdown in Python

Markdown is a light text markup format and a processor to convert that to HTML. The originator describes it as follows: Markdown is a text-to-HTML con

Trent Mick 2.4k Dec 30, 2022
Rich-cli is a command line toolbox for fancy output in the terminal

Rich CLI Rich-cli is a command line toolbox for fancy output in the terminal, built with Rich. Rich-cli can syntax highlight a large number of file ty

Textualize 2.5k Jan 02, 2023
A Python implementation of John Gruber’s Markdown with Extension support.

Python-Markdown This is a Python implementation of John Gruber's Markdown. It is almost completely compliant with the reference implementation, though

Python-Markdown 3.1k Dec 31, 2022
Extensions for Python Markdown

PyMdown Extensions Extensions for Python Markdown. Documentation Extension documentation is found here: https://facelessuser.github.io/pymdown-extensi

Isaac Muse 685 Jan 01, 2023
A automated python script that creates mark-down files to read for the aes keys and other useful information.

Archive A automated python script that creates mark-down files to read for the aes keys and other useful information. Table of Contents Benbot Automat

Tector 13 Dec 14, 2022
Toci is a markdown tool to generate an outline from a given Jupyter notebook.

Toci is a markdown tool to generate an outline from a given Jupyter notebook. It traverses the markdown cells of a given ipynb file to form a toc for you.

Hakan Özler 7 Jan 22, 2022