KO
|
EN
gitlite — search
Search
#javascript
#java
#php
#android
#discord
#docker
#cli
#perl
#atom
#machine-learning
#css
#firefox
deckdown
★ 81
Open GitHub ↗
Write markdown, get a slide deck. No BS.
Download README (.md)
Explore Similar Repositories
droptools
:
Addon bundle for Dropwizard to support jOOQ for database access
suricatta
:
High level sql toolkit for clojure (backed by jooq library)
rtrlib
:
An open-source C implementation of the RPKI/Router Protocol client
slots
:
A multi-armed bandit library for Python
TinyMCE-FontAwesome-Plugin
:
A plugin that lets you insert FontAwesome icons via TinyMCE
// repository documentation
Was this content helpful?
★ 0
(0 ratings)
Select Rating:
★
★
★
★
★
Submit Feedback
Recent Feedback
×
Download README
Do you want to download the
README.md
file for
deckdown
?
Download (.md)
deckdown ========  Write markdown, get a slide deck. No BS. Or JS. Or HTML. Try it at http://deckdown.org ## Usage ### From Text Type or paste [markdown](http://daringfireball.net/projects/markdown/syntax) into the form above, and hit 'create deck'. Valid markdown will be parsed into a deck for you to enjoy. Deckdown currently doesn't save the markdown text that you submit to it so this is a one time, unique thing. ### From A File Tell deckdown the url of your raw `.md` file by passing it as the `src` parameter, like this: ``` http://deckdown.org/deck?src=path/to/yourdeck.md ``` For example, here's a slideshow version of the [deckdown readme](http://deckdown.org/deck?src=https://raw.githubusercontent.com/alanguir/deckdown/master/README.md#/). * Hosting on github Commit your `.md` file to your repo, then navigate to that file on github and click 'raw' in the upper right corner. Use the url of the raw file for deckdown. * Hosting on Dropbox Place the markdown file in your Public folder, then right/option click to get it's public link. Use this public link with deckdown. More info on public links from [dropbox help](https://www.dropbox.com/help/16). * Hosting elsewhere Deckdown can take any publicly available url as an input for generating a slide deck. Links from your local filesystem that begin with `file:///` will not work. For that, just paste the contents of the file into deckdown a-la the *From Text* instructions above. ## Why use it? Deckdown is for breaking out of slideware jail. Traditional slideware is hard to proofread, and tweaking text size and alignment on large decks feels like a waste of time. I love reveal.js (it's used in this project), but the *process* of writing markup around my content in order to present it feels like a new flavor of the old slideware bloat. Deckdown changes all that by taking the contents of a single text file and turning it into a completely acceptable and usable slide deck. Presentations that include code examples may never be the same. I hope you enjoy using deckdown. ## How it works Deckdown breaks your markdown file into slides based on headers and horizontal rules. It does this with *regex*, and it splits up your file **after** converting it to html. This means html header tags `<h1> - <h6>` and `<hr>` become the slide delimiters. When writing your markdown: ``` This Creates a New Slide ======================== #So does this *** (That one does too) ``` Markdown conversion is done with [kramed](https://github.com/GitbookIO/kramed), and uses [GFM](https://help.github.com/articles/github-flavored-markdown) by default. ## Known issues Deckdown is still in an early experimental state. Feel free to use it for your presentations if you wish, just know that sailing is not yet a smooth as it could be. Here are some of the bigger issues keeping deckdown from taking the world by storm: * Images Currently, images are included at their natural size, which can look like an error - especially for .svg or hi-res images. * Overflowing Content Right now, it’s up to the markdown author to anticipate overflowing content, and to chunk accordingly. ## Contribute Deckdown is on [github](http://github.com/alanguir/deckdown). Created 2014 by [Alan Languirand](http://github.com/alanguir/). [MIT license](/LICENSE).
