Live data from Hacker News

Why are we still using Markdown?

bgslabs.org

161–170 of 328 posts

Re: Why are we still using Markdown?

#161
> These 2 produce IDENTICAL output. And this is just the tip of the iceberg?

> It has so many poor decisions baked in that if you try to use it it will actively fight against you the moment you think you know what you’re doing.

That misses the point. The point of Markdown is simplicity, not perfection. And that is also the reason why Markdown will prevail.

Re: Why are we still using Markdown?

#162
post #99
post #65

Earlier quoted context omitted.

I don’t like WYSIWYG editing, as it makes the formatting invisible.

Then you might like Obsidian. When the cursor is in some bit of formatted text, it displays all of the characters. When the cursor is elsewhere, it just shows the formatted text. In the worst case, the barrier to entry and exit are pretty low.

Obsidian has 2 main advantages to me.

First you can switch from WYSIWYG to text editor instantly.

Then you have an outline where you can manipulate your “markdown blocks” [i.e title and its content] by drag n drop. Or extract a “markdown block” as a new note, and leave a reference where it originally was extracted from.

And then [the killing feature], it displays the content of a link, web link or internal link, as a [kind of] iframe, if you prepend a ! to the link.

Re: Why are we still using Markdown?

#163
I'm mostly fine with markdown, but I just wanted to comment, this example in the post

    # Hi
    
    I am a  simple  _programmer_ doing
     elegant  programming.
    
    
    
    And here is my portfolio
    
    
Might not do you think it does. markdown does not include html parser per-se. It allowes HTML but has rules like

    I am a super *grinch* yall
will generate

    

I am a super grinch yall

It doesn't see the span element and turn off parsing.

Similarly, the div in the first example produces div, p, close-p, close-div, because the rule isn't "find he closing tag". The rule is something like "if the line starts with html then stop parsing and just copy until the next blank line.

All that said, I know the rules and generally know how to follow them. Of course I still run into the issue that even though there's commonmark, every site and tool is running their own variation which are incompatible.

Re: Why are we still using Markdown?

#164

Earlier quoted context omitted.

What ambiguities are there with bold ?

Suppose you want to use asterisks to mark footnotes.* As soon as you add a second footnote,** you're in trouble because your asterisks disappear and everything between them turns bold. * I had to escape all of these asterisks. ** I see this happen fairly often to people's comments here.

Disappearing asterisks is just terrible UX. It should turn bold but keep the asterisk displayed so you can still edit as normal.

The bullet point problem is fixed by only bolding when the asterisks are on either end of word characters.

Re: Why are we still using Markdown?

#165
post #150

It is because the primary target for markdown is what would in any other formatting language be the source. Markdown has no source. It is guidelines for good looking plain text layout that when followed can be used to make a typeset document. Everybody sort of knows it sucks as a formatting language. But we love it anyway. The benefit of being able to get a typeset document from a nice looking plaintext document is j…

Unfortunately, the plain text does not look good, and does not offer good control of the typesetting. At least, nearly all markdown I see is almost unreadable in its “raw” state. I’d much rather read manually formatted, monospaced, text. That way, you can use asterisks as bullets, as footnote markers and as emphasis markers all at the same time, and anyone who is familiar with normal typographic conventions will understand what is what.

Re: Why are we still using Markdown?

#166
Markdown is the Python of documents. As technology, and consequently technical writing increase in complexity, any reduction in barrier to access becomes increasingly necessary. The opposite of using markdown and python leads to bike shedding.

Personally, I always default to the simplest of tools. That's why I truly believe that anything meant for actual human use needs to have reasonable defaults. No "look at all the configs you can have", but a "let's get you what you need".

Re: Why are we still using Markdown?

#167
post #139

Earlier quoted context omitted.

On this planet, humans have read HTML without parsing for years. People building their first websites without any significant technical knowledge stole HTML by reading the source of other sites and edited it by hand.

Oh, please . Don't insult everyone here by pretending you actually believe HTML is a human readable format like markdown. It was never designed for that and has never claimed that. What a rediculous thing to even say.

I'm confused. Are you saying you cannot read an HTML file?

Re: Why are we still using Markdown?

#168

Earlier quoted context omitted.

Ugh, troff. It's mind-boggling that the closest way to have an actual (hyper)link in a manpage is to use your pager's "search for text" function. No, "JuSt usE gNu iNfO it'S beTtER" is not an answer either.

troff was originally used to format printed output, where hyperlinks would not make any sense.

But you still have to use it for man pages, even though nobody prints man pages anymore.

Re: Why are we still using Markdown?

#169
post #133

This may be the first time my reaction to an objectively terrible programming language is a shrug and a "whatever". I like using markdown. I use it for journaling in Obsidian. It does everything I want it to. I like that it's just flat files. I don't want my journaling to be stuck in some online database. Yet, I am the same person who refuses to code in anything but Rust due to how not-awful it feels to me. Strange h…

> Markdown in an of itself isn’t powerful enough to satisfy the simple monkey brained developer like me who is only satisfied when the site looks good enough™. Well, indeed, Markdown is an inadequate tool for that. Let the author use more powerful tools, be it HTML, LaTeX, SVG, etc. Markdown is fine for its intended purpose: very light formatting, very simple header structure. If I were not that lazy, i would come up…

> If I were not that lazy, i would come up with something opposite to CommonMark, some MarkDownDown, that does away with alternative ways to format things, most escaping, and most advanced syntax.

https://djot.net/

Re: Why are we still using Markdown?

#170
post #148

Earlier quoted context omitted.

Oh, please . Don't insult everyone here by pretending you actually believe HTML is a human readable format like markdown. It was never designed for that and has never claimed that. What a rediculous thing to even say.

It is. Humans do read it, and have read it. Like any language it's just a matter of familiarity. HTML was designed for humans to read and write long before Claude or compiling everything from typescript or whatever, when websites were all written by hand. In text editors. Even if you were using PHP and templates or CGI you wrote that shit by hand, which meant you had to be able to read it and understand it. Even if y…

[deleted]
Post reply on HN