deckdown - GitLite

KO | EN

gitlite — search

#hacktoberfest #typescript #llm #go #android #deep-learning #docker #macos #java #kubernetes #awesome-list #pytorch #ios #open-source

deckdown

(★ 81)

Write markdown, get a slide deck. No BS.

파일 탐색기

최종 버전 다운로드 (.zip)

- shuffler.js
- - bella.md
  - deckdown.md
  - example.md
  - gulp.md
  - split.js
- - 8ball.png
  - apprend-home.png
  - apprend-logo.png
  - apprend_meetup.png
  - bizdom.jpg
  - blue_bicycle.jpg
  - calling_functions_args_SMS.jpg
  - calling_functions_sayhi_SMS.jpg
  - calling_functions_SMS.jpg
  - classmates.png
  - coffee_shop_blue.jpg
  - deckdown.png
  - evolution.png
  - favicon.ico
  - flyingpig.jpg
  - github_zip.jpg
  - grunt_logo.png
  - gulp_fs_filesize.jpg
  - gulpomg.jpg
  - iosJS.jpg
  - jquery-logo.png
  - mapping_coneys.png
  - paimai.jpg
  - randy.jpg
  - returns.jpg
  - watermelon1.jpg
  - web_app_info.jpg
- - highlight.pack.js
  - jquery-1.11.2.min.js
  - jquery.balancetext.min.js
  - marked.min.js
  - prism.js
  - regex.js
  - reveal.min.js
- - grids-responsive-min.css
  - prism.css
  - pure-min.css
  - pure.css
  - reveal.min.css
  - styles.css
- apprend.less
- breakpoints.less
- deckdown_favicon_black.png
- deckdown_icon.ai
- deckdown_icon_black.png
- deckdown_icon_white.png
- styles.less
- - default.html
- deck.html
- id.html
- index.html
.gitignore
deckdown.js
gulpfile.js
LICENSE
package.json
Procfile
README.md
test.js

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

deckdown
========

![Deckdown](http://deckdown.org/images/deckdown.png)

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).