4 ms·

Second slide of their hello-world example:  ### No more Keynote. ### <span cla

by xkr 9y ago

Second slide of their hello-world example:  ### No more Keynote. ### No more Powerpoint. ### Just Markdown. Then Git-Commit.</li> Doesn't look like a simple markdown for me.

gitpitch 9y ago
Hi @xkr fair point. But to be clear, the hello-world example was written specifically to be embedded in the gitpitch.com website and it was designed to auto-play every slide so it could be watched almost like a short movie. Typical presentations are something that the presenter manually steps through slide by slide as they speak. So needs none of fragment timing snippets you came across. Almost any other GitPitch presentation out there is a better example of what's typically involved, for example, see this presentation from AnyCable: https://gitpitch.com/anycable/anycable https://gitpitch.com/anycable/anycable
- ephimetheus 9y ago
 But it still has all the s for changing the color. That's not specific to gitpitch, but that takes away a lot from markdown I think. Once you start doing that, you can just write HTML to begin with..
 - fenomas 9y ago
 The whole point of markdown is that it covers a very small subset of HTML in a human-readable way, and for any formatting beyond that subset you use regular HTML. Adding tags to customize things is very much the intended way to write markdown.
 - harterrt 9y ago
 Right, but maybe markdown isn't the right markup language for presentations. This may be the correct way to add color in markdown, but it feels unnatural for the tool. I'm glad xkr brought this up it; it feels like hidden complexity.
 - fenomas 9y ago
 I don't follow. Are there other markup languages where you add styling to text in a way that's substantially different from span tags?
dheera 9y ago
Am I the only one that hates markdown? HTML just seems so much more intuitive to me. I can never remember how to make text bold or italic in Markdown. Is it 3 quotes? 2 quotes? Single quotes? Double quotes? Asterisks? Wait, is astersks for bold or asterisks italic? Try all the combinations and see what happens? Compare that to -- b for bold! -- i for italic! Super intuitive! And what about headings? Is it stars? pound signs? random rows of dashes? or is it equals signs? Does more pound signs make it bigger or smaller? What happens if the number of dashes or equals signs is different from the number of characters above it -- will my PC blow up? What if one of the characters is a Chinese character -- does it still count as 1 equals sign? Or 2? Or 3? Is it based on the number of bytes after UTF-8 encoding or the number of multibyte characters? Should I just screw it and use bold text as a heading instead of googling for markdown cheat sheets? Compare that to <h1>, <h2>, ... same syntax as the bold and italic tags so you don't have to memorize a new syntax to do headings once you've learned how to do bold and italics. Isn't that revolutionary? As a bonus, cleanly-written semantically-meaningful HTML you write can be styled to perfection with CSS in any old web browser without any clunky interpreters or middleware. You don't even have to install anything. Isn't that even more amazing? Am I the only one that actually wrote a script to convert HTML to Markdown just so I can create those silly README.md files without having to remember some awfully inconsistent syntax?
- chubot 9y ago
 It helps a lot if you have syntax highlighting for markdown in your editor. I've written my share of bare HTML... I did it that for 10+ years somewhat infrequently. I started a blog and used markdown and now I'm happy. HTML would have been worse for writing frequently IMO. It's annoying to type and annoying to read. One thing that is annoying is that hyperlinks tend to take up a really long line, more than 80 characters. You can't have a space after <a href=""> or before </a>, because that affects the appearance.
- blipmusic 9y ago
 You seem to miss the idea of Markdown. In its original form it was simply an aid to get static html from human readable text (<- that there is the basis for md). For better or worse, it's been forked a few times, adding new abilities or even in efforts to make it stricter. The main idea of readability still applies. I could hand over a markdown formatted txt file to someone and they'd probably read it just fine, whether they could code or not. Html in plain-text form, though? Not sure that would work. It has quirks, but the whole I really like it. I've used it for writing guides, taking notes... Maybe even for web content at some point.

by xkr 9y ago

gitpitch 9y ago

Hi @xkr fair point. But to be clear, the hello-world example was written specifically to be embedded in the gitpitch.com website and it was designed to auto-play every slide so it could be watched almost like a short movie. Typical presentations are something that the presenter manually steps through slide by slide as they speak. So needs none of fragment timing snippets you came across. Almost any other GitPitch presentation out there is a better example of what's typically involved, for example, see this presentation from AnyCable: https://gitpitch.com/anycable/anycable https://gitpitch.com/anycable/anycable

ephimetheus 9y ago
But it still has all the s for changing the color. That's not specific to gitpitch, but that takes away a lot from markdown I think. Once you start doing that, you can just write HTML to begin with..
- fenomas 9y ago
 The whole point of markdown is that it covers a very small subset of HTML in a human-readable way, and for any formatting beyond that subset you use regular HTML. Adding tags to customize things is very much the intended way to write markdown.
 - harterrt 9y ago
 Right, but maybe markdown isn't the right markup language for presentations. This may be the correct way to add color in markdown, but it feels unnatural for the tool. I'm glad xkr brought this up it; it feels like hidden complexity.
 - fenomas 9y ago
 I don't follow. Are there other markup languages where you add styling to text in a way that's substantially different from span tags?

dheera 9y ago

Am I the only one that hates markdown? HTML just seems so much more intuitive to me. I can never remember how to make text bold or italic in Markdown. Is it 3 quotes? 2 quotes? Single quotes? Double quotes? Asterisks? Wait, is astersks for bold or asterisks italic? Try all the combinations and see what happens? Compare that to -- b for bold! -- i for italic! Super intuitive! And what about headings? Is it stars? pound signs? random rows of dashes? or is it equals signs? Does more pound signs make it bigger or smaller? What happens if the number of dashes or equals signs is different from the number of characters above it -- will my PC blow up? What if one of the characters is a Chinese character -- does it still count as 1 equals sign? Or 2? Or 3? Is it based on the number of bytes after UTF-8 encoding or the number of multibyte characters? Should I just screw it and use bold text as a heading instead of googling for markdown cheat sheets? Compare that to <h1>, <h2>, ... same syntax as the bold and italic tags so you don't have to memorize a new syntax to do headings once you've learned how to do bold and italics. Isn't that revolutionary? As a bonus, cleanly-written semantically-meaningful HTML you write can be styled to perfection with CSS in any old web browser without any clunky interpreters or middleware. You don't even have to install anything. Isn't that even more amazing? Am I the only one that actually wrote a script to convert HTML to Markdown just so I can create those silly README.md files without having to remember some awfully inconsistent syntax?

chubot 9y ago
It helps a lot if you have syntax highlighting for markdown in your editor. I've written my share of bare HTML... I did it that for 10+ years somewhat infrequently. I started a blog and used markdown and now I'm happy. HTML would have been worse for writing frequently IMO. It's annoying to type and annoying to read. One thing that is annoying is that hyperlinks tend to take up a really long line, more than 80 characters. You can't have a space after <a href=""> or before </a>, because that affects the appearance.
blipmusic 9y ago
You seem to miss the idea of Markdown. In its original form it was simply an aid to get static html from human readable text (<- that there is the basis for md). For better or worse, it's been forked a few times, adding new abilities or even in efforts to make it stricter. The main idea of readability still applies. I could hand over a markdown formatted txt file to someone and they'd probably read it just fine, whether they could code or not. Html in plain-text form, though? Not sure that would work. It has quirks, but the whole I really like it. I've used it for writing guides, taking notes... Maybe even for web content at some point.

Second slide of their hello-world example:  ### No more <span style="color: #666666">Keynote.</span> ### <span cla

Second slide of their hello-world example:  ### No more <span style="color: #666666">Keynote.</span> ### <span cla