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
Pure-python-server - A blogging platform written in pure python for developer to share their coding knowledge

Pure Python web server - PyProject A blogging platform written in pure python (n

Srikar Koushik Satya Viswanadha 10 Nov 07, 2022
😸Awsome markdown readme for your profile or your portfolio

GitHub Profile Readme Description That's a simple and minimalist README.md for your profile Usage You can download or copy to your repository and make

0 Jul 24, 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
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
Preview GitHub README.md files locally before committing them.

Grip -- GitHub Readme Instant Preview Render local readme files before sending off to GitHub. Grip is a command-line server application written in Pyt

Joe Esposito 5.9k Jan 08, 2023
An automated scanning, enumeration, and note taking tool for pentesters

EV1L J3ST3R An automated scanning, enumeration, and note taking tool Created by S1n1st3r Meant to help easily go through Hack The Box machine and TryH

14 Oct 02, 2022
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
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
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
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
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
Yuque2md - Offline download the markdown file and image from yuque

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

JiaJianHuang 4 Oct 30, 2022
An interactive, terminal-based markdown presenter

lookatme lookatme is an interactive, extensible, terminal-based markdown presentation tool. TOC TOC Features Tour Navigating the Presentation CLI Opti

James Johnson 1.4k Jan 01, 2023
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
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
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 markdown extension for converting Leiden+ epigraphic text to TEI XML/HTML

LeidenMark $ pip install leidenmark A Python Markdown extension for converting Leiden+ epigraphic text to TEI XML/HTML. Inspired by the Brill plain te

André van Delft 2 Aug 04, 2021
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