Whether you’re really passionate about RPC, MQTT, Matrix or wayland, tell us more about the protocols or open standards you have strong opinions on!

You are viewing a single thread.
View all comments
96 points
*

Markdown. Its only in tech-spaces that its preferred, but it should be used everywhere. You can even write full books and academic papers in markdown (maybe with only a few extensions like latex / mathjax).

Instead, in a lot of fields, people are passing around variants of microsoft word documents with weird formatting and no standardization around headings, quotes, and comments.

permalink
report
reply
51 points

Markdown is terrible as a standard because every parser works differently and when you try to standardize it (CommonMark, etc.), you find out that there are a bajillion edge cases, leading to an extremely bloated specification.

permalink
report
parent
reply
25 points

Agreed in principle, but in practice, I find it’s rarely a problem.

While editing, we pick an export tool for all editors and stick to it.

Once the document is stable, we export it to HTML or PDF and it’ll be stable forever.

permalink
report
parent
reply
11 points

Most ppl have settled on Commonmark luckily, including us.

permalink
report
parent
reply
15 points

Commonmark leaves some stuff like tables unspecified. That creates the need for another layer like GFM or mistletoe. Standardization is not a strong point for markdown.

permalink
report
parent
reply
4 points
*

Have you read the CommonMark specification? It’s very complex for a language that’s supposed to be lightweight.

permalink
report
parent
reply
20 points

Man, I’ve written three novels plus assorted shorter form stories in markdown.

There’s a learning curve, but once you get going, it’s so fluid. The problem is that when it comes time to format for release, you have to convert to something else, and not every word processor can handle markdown. It’s extra work, but worth it, imo.

permalink
report
parent
reply
8 points

Just set up pandoc and Bob’s your uncle. It’ll convert markdown to anything. You’ll never have to open another word processor.

permalink
report
parent
reply
7 points
*

Nice! Thanks for the tip!

Edit: holy shit, how have I never run across that before? That’s a brilliant program right there.

permalink
report
parent
reply
5 points

For sure, I bet full fledged editors like word don’t even let you import it.

permalink
report
parent
reply
2 points

Not correctly, no. Librewriter does a bit better, but still misses some bits

permalink
report
parent
reply
1 point

Silly question why can’t you convert markdown to PDF and pass that to publishers?

permalink
report
parent
reply
4 points

Because it isn’t doc is docx.

Publishers are pissy about such things. Even self publishing (which is what I do now), the various outlets still have limits to what they will use. Amazon accepts something like three file formats, including their own, and pdf isn’t on the list.

I could just do pdf for directly giving them away to people, but even then, epub is usually a better pick in terms of readability since that’s the standard for actual books since ereaders tend to display it better than pdfs. Most people reading books via files would be using something that can give a better experience with epub vs pdf.

permalink
report
parent
reply
11 points

I think Obsidian and Logseq are helping to change this.

permalink
report
parent
reply
7 points

Depends on the type of book. Since you need HTML for all non default styles. Therefore, it raises the bar… you need a bit of web dev knowledge which removes the biggest benefit of markdown: simplicity / ease of use.

permalink
report
parent
reply
7 points

Markdown is awesome, I agree! I did not realize you could extend markdown with anything other than html. The html extension is quite nice to do anything that markdown doesn’t support natively, but I wish there was an easier way to extend markdown. Maybe the ones you listed are what I need.

permalink
report
parent
reply
1 point

Hedgedoc / hackmd support a good amount of extensions out of the box. I think typora and obsidias do also (but not open source).

permalink
report
parent
reply
6 points

I frigging love markdown for everything!

permalink
report
parent
reply
3 points

My main wishlist for markdown, is a better live collaborative markdown editor. Hedgedoc works, but it’s showing it’s age, and they don’t seem to be getting close to releasing v2.

Etherpad also has a markdown extension, but it doesn’t import / export that well.

permalink
report
parent
reply
4 points

It is too basic. I guess something more full-fledged like… typst?

permalink
report
parent
reply
2 points

Typst is a typesetting format - an alternative to LaTeX. Asciidoc is more of a competitor to markdown.

permalink
report
parent
reply
1 point

Learning that currently.

permalink
report
parent
reply
2 points

ReST (restructured text) is a good middle ground. I just wish it had more support outside of the python community. It could use some new/better tooling than Sphinx

permalink
report
parent
reply
4 points

I agree 💯

permalink
report
parent
reply

Linux

!linux@lemmy.ml

Create post

From Wikipedia, the free encyclopedia

Linux is a family of open source Unix-like operating systems based on the Linux kernel, an operating system kernel first released on September 17, 1991 by Linus Torvalds. Linux is typically packaged in a Linux distribution (or distro for short).

Distributions include the Linux kernel and supporting system software and libraries, many of which are provided by the GNU Project. Many Linux distributions use the word “Linux” in their name, but the Free Software Foundation uses the name GNU/Linux to emphasize the importance of GNU software, causing some controversy.

Rules

  • Posts must be relevant to operating systems running the Linux kernel. GNU/Linux or otherwise.
  • No misinformation
  • No NSFW content
  • No hate speech, bigotry, etc

Related Communities

Community icon by Alpár-Etele Méder, licensed under CC BY 3.0

Community stats

  • 8.5K

    Monthly active users

  • 6.3K

    Posts

  • 172K

    Comments