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
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
Yuque2md - Offline download the markdown file and image from yuque

yuque2md 按照语雀知识库里的目录,导出语雀知识库中所有的markdown文档,并离线图片到本地 使用 安装 Python3.x clone 项目 下载依

JiaJianHuang 4 Oct 30, 2022
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
Remarkable Markdown Debian Package Fix

Remarkable debian package fix For some reason the Debian package for remarkable markdown editor has not been made to install properly on Ubuntu 20.04

Eric Seifert 37 Jan 02, 2023
Static site generator that supports Markdown and reST syntax. Powered by Python.

Pelican Pelican is a static site generator, written in Python. Write content in reStructuredText or Markdown using your editor of choice Includes a si

Pelican dev team 11.3k Jan 05, 2023
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
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 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
Markdown parser, done right. 100% CommonMark support, extensions, syntax plugins & high speed. Now in Python!

markdown-it-py Markdown parser done right. Follows the CommonMark spec for baseline parsing Configurable syntax: you can add new rules and even replac

Executable Books 398 Dec 24, 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
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
Mdformat is an opinionated Markdown formatter that can be used to enforce a consistent style in Markdown files

Mdformat is an opinionated Markdown formatter that can be used to enforce a consistent style in Markdown files. Mdformat is a Unix-style command-line tool as well as a Python library.

Executable Books 180 Jan 06, 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
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
Mdut: a tool for generating Markdown URL tags

mdut mdut (pronounced "em-doot") is a tool for generating Markdown URL tags. It

Nik Kantar 2 Feb 17, 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
Markdown journal template.

Markdown Journal Template Description This project contains a script which creates a markdown journal template for the current year by creating a mark

Stephen McAleese 2 Mar 06, 2022
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
Comprehensive Markdown plugin built for Django

Django MarkdownX Django MarkdownX is a comprehensive Markdown plugin built for Django, the renowned high-level Python web framework, with flexibility,

neutronX 740 Jan 08, 2023
Read a list in markdown and do something with it!

Markdown List Reader A simple tool for reading lists in markdown. Usage Begin by running the mdr.py file and input either a markdown string with the -

Esteban Garcia 3 Sep 13, 2021