Close Menu
Best in TechnologyBest in Technology
  • News
  • Phones
  • Laptops
  • Gadgets
  • Gaming
  • AI
  • Tips
  • More
    • Web Stories
    • Global
    • Press Release

Subscribe to Updates

Get the latest tech news and updates directly to your inbox.

What's On

Gorgeous Hand-Drawn Metroidvania Constance Gets November Release Date On PC, 2026 For Consoles

8 June 2025

Owlcat Games Reveals The Expanse: Osiris Reborn

8 June 2025

Bill Atkinson, Macintosh Pioneer and Inventor of Hypercard, Dies at 74

8 June 2025
Facebook X (Twitter) Instagram
Just In
  • Gorgeous Hand-Drawn Metroidvania Constance Gets November Release Date On PC, 2026 For Consoles
  • Owlcat Games Reveals The Expanse: Osiris Reborn
  • Bill Atkinson, Macintosh Pioneer and Inventor of Hypercard, Dies at 74
  • Fading Echo Is A Magical Puzzle Platformer With An All Star Cast, And It’s Launching Soon
  • Check Out System Shock 2: 25th Anniversary Remaster’s Multiplayer In New Gameplay Trailer
  • Get A New Look At Sleep Awake, A Psychedelic Horror Game From Blumhouse And Nine Inch Nails’ Robin Finck
  • Killer Inn Is Square Enix’s Take On Among Us
  • Arc Raiders Gets October Launch Date
Facebook X (Twitter) Instagram Pinterest Vimeo
Best in TechnologyBest in Technology
  • News
  • Phones
  • Laptops
  • Gadgets
  • Gaming
  • AI
  • Tips
  • More
    • Web Stories
    • Global
    • Press Release
Subscribe
Best in TechnologyBest in Technology
Home » The Eternal Truth of Markdown
News

The Eternal Truth of Markdown

News RoomBy News Room24 June 20243 Mins Read
Share Facebook Twitter Pinterest LinkedIn Tumblr Reddit Telegram Email
Share
Facebook Twitter LinkedIn Pinterest Email

Markdown became a core part of how I wrote. The simplicity and flexibility meant I would live the dream of write once, run anywhere. It did lead to some ambiguity, though. Gruber would probably say this is by design. His emphasis throughout the Markdown documentation is on the syntax of Markdown, not—say—the resulting HTML. His Perl script does not support HTML class names or IDs, for example, so you can’t add those to the generated HTML. By the logic of the original Markdown script, if you want complete control over the HTML output, then you’d need to write in HTML.

This situation is great for Markdown users: that is, writers. It’s less great for programmers. In fact, it drives them crazy. Programmers do not like ambiguity. It goes against so much of what programming is about. As a writer using Markdown, I love that I can pick whichever particular version is best suited to my needs. As a programmer, I hate that when I build something I have to make this same decision, which then affects all the people who use my finished product. Maybe I didn’t support some specific extension they were expecting because they’ve always used the same Markdown parser and assume that feature is available.

If this weren’t bad enough, there are also some ambiguities in the syntax. For example, asterisks are used for italics when singular (*like this*) and bold when doubled (**like this**). So far so good. But what should happen if you write **like* this**? Should that be rendered like* this? Or maybe like this*? There’s no way to know; whoever is writing the parser has to make that decision.

What’s more, unlike most extremely successful pieces of code, Markdown is not publicly hosted on the code-sharing site du jour. It doesn’t have hundreds of people contributing to it, and the last time the original Perl script was updated was 2004. This too rubs programmers the wrong way. We’re a cliquish bunch; things outside the clique are viewed with suspicion.

About a decade ago, there was an effort to eliminate the ambiguities in Markdown and bring it into line with coding dogma. Some programmers got together and created CommonMark, which makes the choices the original Markdown script doesn’t and came up with what its creators think is the One Right Way to Do It.

CommonMark offered comfort. It’s on Github. It has a discussion forum. It seems to be an active project. I have never personally incorporated CommonMark into a project, but its parsers are what convert your Markdown to HTML on such popular sites as Stack Overflow, Github, and Reddit. (To eliminate the asterisk ambiguity, for example, it proposed underscore for italics, asterisk for bold.) Presumably the developers behind CommonMark consider it a success.

But it’s not Markdown. Not in name, and I would argue not in spirit.

Around the time the CommonMark effort was happening, the software developer Dave Winer told me something I still think about: Markdown belongs to everyone who uses it. This is literally true because of the license. But it also reminded me of the real point of free software. We all have a say in it: by using it, by adapting it, even by forking it.

Whether Gruber intended it this way or not, Markdown does belong to everyone, and there is no standard. I use a very old version of Markdown for Python. Gruber presumably still uses his Perl script. Other people use other versions. It’s messy. It’s ambiguous. It’s human.

And this, in the end, is the Way.

Share. Facebook Twitter Pinterest LinkedIn Tumblr Email
Previous ArticleTecno’s Phantom V2 Fold Pops Up on Bluetooth SIG Website; Launch Could Be Imminent
Next Article Unwelcome at the Debate, RFK Jr.’s Star Shines on TikTok Live

Related Articles

News

Bill Atkinson, Macintosh Pioneer and Inventor of Hypercard, Dies at 74

8 June 2025
News

Samsung Teases Z Fold Ultra, Bing Gets AI Video, and Nothing Sets A Date—Your Gear News of the Week

7 June 2025
News

The Best Backpacking Tents

7 June 2025
News

Security News This Week: The Mystery of iPhone Crashes That Apple Denies Are Linked to Chinese Hacking

7 June 2025
News

Tech Up Your Sourdough With These Upper-Crust Baking Gadgets

7 June 2025
News

Everything You Need to Know About MicroSD Express

7 June 2025
Demo
Top Articles

Costco partners with Electric Era to bring back EV charging in the U.S.

28 October 202495 Views

ChatGPT o1 vs. o1-mini vs. 4o: Which should you use?

15 December 202493 Views

5 laptops to buy instead of the M4 MacBook Pro

17 November 202466 Views

Subscribe to Updates

Get the latest tech news and updates directly to your inbox.

Latest News
Gaming

Get A New Look At Sleep Awake, A Psychedelic Horror Game From Blumhouse And Nine Inch Nails’ Robin Finck

News Room7 June 2025
Gaming

Killer Inn Is Square Enix’s Take On Among Us

News Room7 June 2025
Gaming

Arc Raiders Gets October Launch Date

News Room7 June 2025
Most Popular

The Spectacular Burnout of a Solar Panel Salesman

13 January 2025123 Views

Costco partners with Electric Era to bring back EV charging in the U.S.

28 October 202495 Views

ChatGPT o1 vs. o1-mini vs. 4o: Which should you use?

15 December 202493 Views
Our Picks

Fading Echo Is A Magical Puzzle Platformer With An All Star Cast, And It’s Launching Soon

8 June 2025

Check Out System Shock 2: 25th Anniversary Remaster’s Multiplayer In New Gameplay Trailer

7 June 2025

Get A New Look At Sleep Awake, A Psychedelic Horror Game From Blumhouse And Nine Inch Nails’ Robin Finck

7 June 2025

Subscribe to Updates

Get the latest tech news and updates directly to your inbox.

Facebook X (Twitter) Instagram Pinterest
  • Privacy Policy
  • Terms of use
  • Advertise
  • Contact Us
© 2025 Best in Technology. All Rights Reserved.

Type above and press Enter to search. Press Esc to cancel.