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
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 6, 2023
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 7, 2022
A fast yet powerful Python Markdown parser with renderers and plugins.

Mistune v2 A fast yet powerful Python Markdown parser with renderers and plugins. NOTE: This is the re-designed v2 of mistune. Check v1 branch for ear

Hsiaoming Yang 2.2k Jan 4, 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 5, 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
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 1, 2023
Livemark is a static page generator that extends Markdown with interactive charts, tables, and more.

Livermark This software is in the early stages and is not well-tested Livemark is a static site generator that extends Markdown with interactive chart

Frictionless Data 86 Dec 25, 2022
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
A lightweight and fast-to-use Markdown document generator based on Python

A lightweight and fast-to-use Markdown document generator based on Python

快乐的老鼠宝宝 1 Jan 10, 2022
Yuque2md - Offline download the markdown file and image from yuque

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

JiaJianHuang 4 Oct 30, 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 30, 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
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 1, 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
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 8, 2023
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

null 659 Jan 4, 2023
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 super simple script which uses the GitHub API to convert your markdown files to GitHub styled HTML site.

A super simple script which uses the GitHub API to convert your markdown files to GitHub styled HTML site.

Çalgan Aygün 213 Dec 22, 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 2, 2023