I like my Markdown notes editor, but I agree it's not the right choice for Apple notes because exposing the underlying machinery in everyday use is not Apple's style.
It’s also not handy to reach the mark-up characters from a touch keyboard. And if you are adding backticks and asterisks to a markup bar, you might as well just add bold and italics to the markup bar.
This varies a bit by touch keyboard. The standard iPhone keyboard is particularly bad at this while the AOSP and Google keyboards on Android aren't so bad.
Joplin, the notes app I've been using lately does have a markup bar with those features.
"Markdown is a good tool for a specific purpose, and generalized note taking isn't it."
As someone who enjoys note-taking in Obsidian (by far my favorite super-powered markdown editor), I respectfully disagree with the premise and conclusion. On the contrary, IME, MD isn't single-purpose, and it absolutely can and does serve as a first-rate format for note-taking.
I take my notes in INI format with a lose schema, as I accumulate data I tend to move towards something more concrete and write tools for it. I think this is the absolute best compromise between some kind of formal personal ERP-like (PRP?) system and something super loose like Markdown or org mode.
Of course doing this on an iPhone is an absolute nightmare because everything has to be blessed by Apple and you can't just do one-off ad-hoc automations or usefully compose tooling that touches the filesystem. Everything has to be canned and sharecropped (at best) so them adding Markdown to the only text editor that supports fast, energy efficient background sync is a huge deal.
When I had an iPhone I did try doing some server-side automation with the SGML-like (can't remember if it was actual HTML or not) format notes used. Like most of those sorts of things it was a miserable uphill fight to get value out of the thing. I've been so happy ever since I've completely given up on anything smartphone related.
Did you ever test drive the Drafts app? It is remarkably easy to build customized workflows, both editing and document processing, and is built to be glue between different document/message apps.
It's a little late for that now since I don't own a smartphone anymore but it looks like there isn't a Linux version so the usefulness to me would have been limited anyway.
> Occasionally I notice a burst of traffic to Daring Fireball from Hacker News. It’s always short-lived, because for reasons I’ve never seen explained, Daring Fireball articles always get blacklisted from Hacker News once they hit their front page
It seems to me that he concludes that he's blacklisted because the traffic coming from Hacker News is short-lived?
> Daring Fireball articles seemed more or less appropriately popular there. Articles that I would think would resonate with the HN readership would hit, and get what always seemed to me an appropriate number of comments.
So this guy seems to think that he can predict what will be popular and what will not? I think he's burying the lede here, who cares about being blacklisted, this guy can tell the future !
Isn't it much more likely that his posts are just less popular, and drive less engagement than he hopes? Most people (even very smart people) are bad at meta-cognition, and are likely to fall in the trap of reasoning based on (hidden) assumptions.
If this guy actually has evidence of being blacklisted/botted I would be open to see it, but lack of engament isn't that.
He probably was blacklisted in some way and his recent complaints (which attracted a fair amount of attention here) probably led to dang et al reconsidering.
I can’t imagine there are a lot of Stallman-types here. After all, HN is the discussion forum for Y Combinator, a startup accelerator and VC group.
There is a whole pile of dang comments about this brouhaha, he wasn't 'blacklisted', that's just something Gruber imagined because his articles don't do all that well on HN these days. People become less popular without HNs help.
As its author, he’s right though. There really shouldn’t be a standard considered Standard Markdown. It muddies the fact that it wasn’t published by its author.
Maybe Common Markdown would have been a better name between a few large orgs.
GFM predates microsoft’s acquisition of github by one year as a formal spec and six years as an informal one - but ms hardly has a monopoly on embrace-extend-extinguish.
It was briefly renamed Common Markdown as well, and John hated on that as well, so it became CommonMark.
And now we're in an odd position where Github and friends all validate their implementations against the CommonMark suites, but refer to the result as "Markdown" to their users, which makes the work they're doing maintaining that stuff especially thankless.
At the time of the SM/CM/CommonMark kerfuffle a decade ago, Gruber was quite explicit that "X Flavored Markdown" was perfectly fine with him— Atwood even includes the relevant podcast snippet:
The thing he’s wrong about is not the name, it’s that markdown doesn’t need a standard. Markdown absolutely needed a spec, and gruber resisted that which is why the spec was done without him and has to be confusingly called CommonMark instead of just being markdown.
I mean it’s lot like he’s touting some fringe thing just because he made it. It must be so weird to see markdown become the lingua franca of everything from online forums to LLMs.
That's actually a nice perk since I have LLMs summarize or re-word my research findings quite often. I'm a disorganized person, so they've been a big help with me organizing my work.
I also like that Markdown is being added since it's what I typically use for documentation (github, etc). The default formatting in notes currently leaves something to be desired...
Shortcuts has Rich Text -> Markdown and Markdown -> Rich Text actions.
I made a couple quick shortcuts to go both ways, with the clipboard as both the input and output. I put a widget for this on my desktop and it makes it pretty easy. Not as easy as native support, but not bad.
Kinda stoked for this. Been working on a notes app and apple notes is my current daily driver. Apple notes stores the notes in a proprietary and opaque format atm. I’ve been scheming ways to break the notes out without luck. Now I can just wait for this feature to come out.
So first of all, I like Apple notes for its simplicity and ability to sync with iCloud. I don't really care if it's exportable using markdown, I only really care that it is exportable. Because I'd like to migrate to the notes app I am working on.
Was also in your boat, but realized there are various tools to export Apple notes as markdown that work reasonably well; Obsidian itself recommends one[1]. Meanwhile, I'm impressed that Apple notes keeps getting better. It was _almost_ good enough for me to abandon my own note taking app. The things that slowly drove me nuts were lack of real code formatting and lack of image formatting (after they added note linking and tagging, the prior issues I had). I'm still surprised how long it takes most notes apps to get decent out of the box image formatting; few would want to drop an image onto their note and have it blown up to take up the full page by default. Just make your notes app look like the typical blog by default and _most_ people will love it[2].
Its fairly common to use markdown as shortcuts to WYSIWYG content - Obsidian and Notion for instance. At a higher level at some point if you want a fluid typing experience, you need some form of shortcuts, and given markdowns conciseness and ubiquity its a good choice as opposed to having a proprietary format users need to learn for just your app.
+1 - a universal way of doing this via markdown beats learning whatever app-specific hotkeys I have to do to make an H3 or whatever. I don't have any particular feelings about markdown as a format for data, but as a universal set of shortcuts, I've found it to be a huge productivity boost.
I cannot understand how Apple notes works sometimes.
For instance, sometimes after indenting a line I cannot un-indent on future lines. Just fighting the tool.
Stuff like this really makes me dislike it. I find syntax highlighting with markdown preferable than a WYSIWYG rich text editor. I get why people who don't know markdown prefer it, but the advantages diminish significantly if you know markdown.
> For instance, sometimes after indenting a line I cannot un-indent on future lines
I feel like this is why a lot of us use Markdown/Org, because this is the most annoying issue in Word to me since 2003. Why are the indentation rules so arbitrary?
I don’t use word processors often (less than once a year in general), and did something comparatively advanced in LibreOffice Writer a few months ago, involving mixing English and an Indian language, and trying to use styles and such (equivalent to tacking on a stylesheet in HTML). I learned that the toolbar button for lists creates a list with hard-coded inline styles for bullet appearance, indent amounts, &c. If you want to change it, you can’t use that button any more, and have to make your own style with the appropriate properties (not easy) and apply them to each list item.
Part of the mess is that it doesn’t seem to actually model lists, just paragraphs which might have a list level associated with them. I have no idea why this was ever deemed acceptable: it precludes multiple markers on one line:
1. a) Sorry, but you can’t do this.
b) It’s not expressible.
2. You need a paragraph first.
a) Then it can be done.
My guess is that LibreOffice inherited this limitation from Word. No idea if Word is so affected.
I actually love that this was glossed over by him and most of the comments. I used Apple notes daily for years - hundreds or maybe thousand+ notes in it. The idea that markdown is easy to mess up compared to Apple notes is at best partially true. Apple notes messes up too, and in weird ways. The reality is if not markdown, its using its own syntax under the hood that is certainly not bug free, and will have its own (proprietary) bugs to deal with. And since its not markdown, you can't drop to raw text to fix it, or even understand it. Which is the whole reason more and more apps are moving towards it: You don't need to re-invent the wheel for all the standard note features, including your own special flavor of bugs. Apple notes realistically can't use Markdown in its UI. But if it could, having a toggle to flip to it would be lovely, especially when their UI gets buggy - there's always a plain text work around that's easy to understand, and fully human readable on its own.
When Gruber mentions that he never uses Markdown outside of his blog, and hinting at the fact that it was not intended for text editors (and other apps), there's one important point I want to make.
Yes, Markdown has disadvantages, and a few rough edges for uses as the format for editors et al, but there are two very big advantages and/or sideffects of it's widespread use: (1) it's cleartext and therefore very good as a measure against vendor lock-in and (2) it has, to some extent, dampened the rampant "not-invented-here"-esqe tendency to use proprietary formats. Even in open-source apps, proprietary formats make it hard for non-dev users to get their stuff out. If it's markdown (or at least supports markdown export) from the beginning, at least you know you can take your data with you.
> which I think is what _really_ drove a lot of the adoption
That GitHub used it as a "native" format everywhere from the beginning (as far as I remember), probably helped Markdown become at least as popular (or maybe even more) as GitHub itself.
Then everyone and their mother started doing static blogs, and since people already wrote their READMEs and issue comments with Markdown, I guess it was natural to want to write your blogposts with Markdown too, just like Gruber.
It is funny to occasionally see it explained like 'on Reddit you can use ...' and think '..dude, markdown, just tell them you can use markdown' (and then realise oh right yeah ok, your way is probably clearer to them and you probably don't know it as 'markdown' either).
Reddit's Markdown flavor is a bit weird though. It got closer to CommonMark with New Reddit, but the rest of the UI got worse, and people using Old Reddit don't get the formatting the new version supports, so things like code blocks are often broken.
I get bold and italic confused because Google Chat is almost-Markdown except for * being bold and _ being italic (whereas it's double vs singular in classic Markdown).
My company is on Teams and I regularly use Markdown in my messages, though I still struggle to remember that I have to use underscores not asterisks for italics.
As for Teams, it looks like it’s much closer to Markdown (uses the same idiosyncratic/stupid link syntax), but still significantly incompatible even if they call it that. And my guess (as a non-user) is that it’s just an input method immediately converted to HTML or similar, not retained as text. So in that way it’s not Markdown either.
I can’t provide usage numbers, but it used to be the happy path for using GitHub Pages. I suppose static site generation was fairly niche so “popular” may not be the right word. I think Jekyll was a big fish in a little pond, however.
It's simple but has good enough capabilities and it's available in a universal format (plain text) that will never expire or get sold or become inaccessible
Markdown is like the new WordPerfect for some people, who want expressive written paths to format text.
Like with WordPerfect, there are people who get great utility (attorneys in WP, developers with Markdown), but 80-95% of people don’t get anything out of it.
It’s also one of those things where the constraints are an advantage. Markdown is great for internet facing text content, while many aspects of the mainstream wysiwyg editors are really descended from solutions for placing text on paper.
There’s no free lunch. On the flip, that user wants the complex features of the platform, and exposing them to a markup language takes elegant markdown and turns it into html or ooxml.
lol. I’m not sure if that’s an insult or a compliment. I use message boards to blow off steam, and have never used any LLM to write anything. Genius or idiot, purely organic writing. :)
Attorneys and architects loved Word Perfect because it did line numbers better than any other software. I'm really surprised that MS didn't pick up on that and improve Word's line numbering: it's a vital feature for a number of professions.
> Attorneys and architects loved Word Perfect because it did line numbers better than any other software.
Lawyer here: I loved WordPerfect (for DOS) because of Reveal Codes and its easy keystroke macros, which let me write an Emacs keyboard emulator for it. (Yes, I eventually did one for Microsoft Word for Windows, which I use to this day.)
I posted the DOS version on CompuServe (!) probably 30 or 35 years ago. I don't think I ever posted the Word for Windows version. I switched to a MacBook a dozen years ago; I think I remapped some of its keys to emulate Emacs. (But in recent years I've used mostly Emacs itself and org-mode, because these days I'm mostly a law professor and use Word mainly in the occasional client contract-negotiation project.)
Former lawyer here. That most commercial contract work is done in Word is a source of major frustration and wasted time for many lawyers. Others are simply unaware that there are any authoring/editing paradigms that allow one to separate the drudgery of getting document formatting just-so, from the actual value-additive work.
Unfortunately there’s no realistic solution to the lock-in, so wrestling with broken paragraph formatting, mismatched text sizes, auto-numbering errors, etc at 2am before a client deadline remains the norm. One of the most frustrating parts of the job.
I never have those issues, but I'm the only one editing my stuff. I use styles religiously when I use Word for professional documents. It takes a little more time and effort but pays out over the long haul.
I was on a project and complained heavily that we were not using styles,. The complaints got my manager to state that another person would do all the formatting. Of course the other person left befor the end and I had to do all the formatting.
That’s why. If you use styles and embrace sanity in general, it’s fine. But word is like Perl, there’s more than one way to do it.
Paste additions to the middle of a numbered list from legacy documents that break the number sequence and use custom fonts altar create weird problems? Sure.
Allow sociopaths to format text using a series of invisible text boxes? Sure.
Decide to randomly lose the names of editors and contributors? Sure.
Everyone gets something out of markdown, even the 80-95% of document writers that don't get what they want out of it for writing don't have to read as much slop from the others in their group.
Many formats these days are cleartext. Microsoft Office documents and LibreOffice documents, to name two collections of formats, are both xml based. Not to mention HTML, Latex - the list is long. Markdown is fine but overused, to the point where even the creator is now warning it’s not for everything.
Agreed. For me, the popularity of Markdown on (pre-Microsoft) GitHub and GitLab was all I needed, to declare that the company wiki, code-embedded API docs, and anything else appropriate should just use Markdown.
Markdown is good enough for most of the documentation that software engineers do (other than diagrams), they already have to know it, and I don't want yet-another-markup-language to be a barrier to capturing and communicating institutional knowledge.
I also tell people that, if you're new to Markdown, even a plain text approximation that doesn't quite format correctly is strongly encouraged, so long as they capture the info somewhere accessible. I'll even offer to cheerfully fix the missing/bad Markdown, so that we have working docs and people can learn the very few parts of Markdown they missed; it's really not much.
(I personally have heavily used many much-much better technical documentation systems, and helped develop a WYSIWYG-ish SGML-based one professionally, but just using Markdown is a no-brainer right now. There are much more important things I want people learning and doing, than N different ways of minimally formatting documentation in N different places.)
No, mermaid is not fine. You don't have fine control over layout and composition, you can't place your own media and annotations where you like, you can't even use the correct icons for things like databases and cloud services. I usually go into Figma for anything more complex than about 7 entities or if I need to tell a story with composition.
I agree. I use markdown a lot and was trying to use Mermaid for diagrams in it and it was frustrating. Among the biggest issues I ran into was that text was constantly cut off or covered up.
A mix plantuml for constrained no-frills diffable standard diagrams and yEd for actual manual placement and boxes-and-arrows drawing - local editing, both can be scripted to export to an image format - is a good local optimum. I haven't found a much better combination for years.
I love the relative simplicity of core markdown with if I need to get fancy to add some html (which is rare) and it works so well in programs like Joplin, rather than fighting weird formatting in programs like OneNote and EverNote
Markdown was here before the other (currently) big formats and will be here after them. It's not perfect, but at least I don't need to worry about it disappearing on me like every other piece of tech and software I own.
> (1) it's cleartext and therefore very good as a measure against vendor lock-in and (2) it has, to some extent, dampened the rampant "not-invented-here"-esqe tendency to use proprietary formats.
Isn't it a bit early to have thoughts about something we don't know the UI/UX of? Could be that "Markdown support" is just "Import/Export as Markdown", or even just export. Or it could be a fully fledged WYSIWYG editor.
The rumors seem to indicate just "Export as Markdown", which seems to be exactly what Gruber wants, according to the last 10% of the blogpost. So the rest is ranting against an implementation that doesn't seem like it'll happen?
Notes is already a WYSIWYG editor, with a feature-set exceeding that of plain Markdown (handwritten notes, math formulas and plots, colored highlighting, etc.). In the general case, Markdown export and re-import would likely be lossy, or would have to use HTML elements for non-Markdown features. The main question IMO is if they’ll add Markdown source visualization and source editing, in addition to export/import. It could conceivably even just be export, without import.
Gruber is famously protective of the original Markdown specification and his specific use case. He’s reacting to others’ expectations and clarifying his position that a “Markdown editor” is a bit of an oxymoron. He supports that position by reiterating his inspiration for creating the format.
I understand his point, but I disagree with it. Markdown wasn’t invented for the purposes we use it for today, true. And yet the most popular programming editor today is a website running inside a modified browser, themed with CSS and extended with JavaScript.
We have a tendency, as a group, to push things beyond their original intent.
It seems sort of odd to have an “export to markdown” command. Markdown is nice… because it is sort of like a normal markup language, but easier to write, right? But exporting is specifically the one case where markdown’s strength doesn’t matter. The computer can type, like, real fast and can output verbose and niche syntax easily.
Why not export to the best format, LaTeX? I don’t think anyone could argue that Markdown is better than LaTeX as long as you don’t actually have to write it.
I’m constantly sending URLs to people, like https://somesite.com/login. The point of these links is usually that people read them and understand them.
But the automatic behavior is to replace the text with OpenGraph links, big obnoxious bubbles of graphics, which distort or destroy the meaning that I’m trying to convey.
Given the opportunity, I would send most links wrapped in `backticks`.
For those who don't know, you can tap on the link preview graphic and select "Convert to Text Link" to switch back to clickable text. As you mention there's no way to change the automatic behavior but at least it is possible to switch back to text links on a case-by-case basis.
I hacked up something like this for Apple Notes. It’s far from perfect, but at least it lets me type Markdown-style punctuation and get the expect results. Think of it like a crummy Vim mode sort of thing.
If you want a Mac email program that renders Markdown, definitely checkout MailMate[1]. Indie developer, has already shipped a lot of updates this year.
OneNote lets you add content in a canvas. It would be cool if there was an ASCII canvas note taking tool but I think it would have to be built on plain text from the ground up.
Yeah I meant just within the individual text blocks, the canvas itself can't be Markdown of course
It's such a more convenient way of "styling while you type" and has become the de facto way to do that... in Slack, Reddit comments, GitHub, Jira, Confluence etc... even MS Teams, they all allow Markdown "styling while you type"
I was a heavy user of MS OneNote. It got slower and slower as I added more notes. And some notes got long. And then I discovered Obsidian with Markdown support. Now the idea of using OneNote sends shivers down my spine.
I have some big notes and tbh I find it totally fine (on macOS)
The two things that would make a world of difference to me are:
- having a 'code block' style, preferably accessed via familiar single and triple-backticks markdown syntax
- for the Android app to have a "magnifying cursor" like mobile apps are all supposed to have... trying to edit a note and drag the cursor around with your finger without having the little magnifying popup is a complete pain
Obsidian user here. BUT I also have a lot of stuff in Apple Notes. Have wanted to consolidate but always seemed to much of a chore. This is awesome for my use case. Kudos to Apple for adding this!
100% agree with the sentimment. markdown is hell as a format for editors :D
the effort it takes to serialize and parse markdown into an AST that rich text editor frameworks reliably operate on takes months. been there, done that. the majority of the engineering effort of building a markdown editor in the browser went into parsing and serializing markdown :/
I’ve trained our support staff on basic markdown syntax and while we do use it predominantly for spitting out documentation and guides and whatnot, its usefulness far exceeds the original intent. And that’s okay.
Funny. I am in the process of providing basic training on Markdown to our support staff. I think more than 80% of what we now write is in Markdown format. It is easy to read/write for humans. And AI.
Yeah, I understand that it might get confusing to use multiple implementations, or to transition between the two, but I seriously doubt these claims that “regular people” (as in, people who are expected to know how to use Word) are struggling with the syntax itself.
The article pretends that Markdown got popular because “it was there”. 15 years ago people were adopting it _because_ it is dead simple, unobtrusive, and visually evocative.
The ones who made it popular, in other words, did so quite intentionally.
228 comments
[ 3.4 ms ] story [ 231 ms ] threadAs an aside, I have a dream that Apple Notes could be piped into a website as a form of blogging. As it is, I haven't found a way to do it...
Joplin, the notes app I've been using lately does have a markup bar with those features.
As someone who enjoys note-taking in Obsidian (by far my favorite super-powered markdown editor), I respectfully disagree with the premise and conclusion. On the contrary, IME, MD isn't single-purpose, and it absolutely can and does serve as a first-rate format for note-taking.
Of course doing this on an iPhone is an absolute nightmare because everything has to be blessed by Apple and you can't just do one-off ad-hoc automations or usefully compose tooling that touches the filesystem. Everything has to be canned and sharecropped (at best) so them adding Markdown to the only text editor that supports fast, energy efficient background sync is a huge deal.
When I had an iPhone I did try doing some server-side automation with the SGML-like (can't remember if it was actual HTML or not) format notes used. Like most of those sorts of things it was a miserable uphill fight to get value out of the thing. I've been so happy ever since I've completely given up on anything smartphone related.
Not sure if it's a blacklist as much as people insta-flagging, as happens with a many of the political-adjacent posts.
> Occasionally I notice a burst of traffic to Daring Fireball from Hacker News. It’s always short-lived, because for reasons I’ve never seen explained, Daring Fireball articles always get blacklisted from Hacker News once they hit their front page
It seems to me that he concludes that he's blacklisted because the traffic coming from Hacker News is short-lived?
> Daring Fireball articles seemed more or less appropriately popular there. Articles that I would think would resonate with the HN readership would hit, and get what always seemed to me an appropriate number of comments.
So this guy seems to think that he can predict what will be popular and what will not? I think he's burying the lede here, who cares about being blacklisted, this guy can tell the future !
Isn't it much more likely that his posts are just less popular, and drive less engagement than he hopes? Most people (even very smart people) are bad at meta-cognition, and are likely to fall in the trap of reasoning based on (hidden) assumptions.
If this guy actually has evidence of being blacklisted/botted I would be open to see it, but lack of engament isn't that.
"People that dislike X must think Y" is reductive and divisive.
I can’t imagine there are a lot of Stallman-types here. After all, HN is the discussion forum for Y Combinator, a startup accelerator and VC group.
Maybe Common Markdown would have been a better name between a few large orgs.
But everyone seems to have their own slightly different flavor, either pre- or post- that "standardization".
https://github.github.com/gfm/
And now we're in an odd position where Github and friends all validate their implementations against the CommonMark suites, but refer to the result as "Markdown" to their users, which makes the work they're doing maintaining that stuff especially thankless.
https://blog.codinghorror.com/standard-markdown-is-now-commo...
Honestly the whole thing is so ridiculous.
I suspect LLMs, not users, have been the requesting this feature at Apple.
I also like that Markdown is being added since it's what I typically use for documentation (github, etc). The default formatting in notes currently leaves something to be desired...
I made a couple quick shortcuts to go both ways, with the clipboard as both the input and output. I put a widget for this on my desktop and it makes it pretty easy. Not as easy as native support, but not bad.
Apple Notes Expected to Gain Markdown Support in iOS 26
https://news.ycombinator.com/item?id=44183923
I haven't used Notes in decades other than to type out junk/numbers once every 4 months.
Among other reasons, because the sync experience is second to none.
Some of the other reasons:
- Apple Pencil
- Shared notes with friends and family (vacation planning, lists, etc)
[1]: https://help.obsidian.md/import/apple-notes. [2]: tbf it took me quite a bit of work to get there in my own app, and its still got bugs
Export notes by folder: https://www.icloud.com/shortcuts/3aed9f1608ce4efeb31a276ad02...
Export all notes: https://www.icloud.com/shortcuts/1b305195692e42c19d258989475...
Notes to html: https://www.icloud.com/shortcuts/1a61fe549b7c41d7b2e3511ee12...
For instance, sometimes after indenting a line I cannot un-indent on future lines. Just fighting the tool.
Stuff like this really makes me dislike it. I find syntax highlighting with markdown preferable than a WYSIWYG rich text editor. I get why people who don't know markdown prefer it, but the advantages diminish significantly if you know markdown.
I feel like this is why a lot of us use Markdown/Org, because this is the most annoying issue in Word to me since 2003. Why are the indentation rules so arbitrary?
Part of the mess is that it doesn’t seem to actually model lists, just paragraphs which might have a list level associated with them. I have no idea why this was ever deemed acceptable: it precludes multiple markers on one line:
My guess is that LibreOffice inherited this limitation from Word. No idea if Word is so affected.I've not experienced any issues unindenting but not sure how you're doing it?
On macOS, tab and shift-tab always work for me.
Yes, Markdown has disadvantages, and a few rough edges for uses as the format for editors et al, but there are two very big advantages and/or sideffects of it's widespread use: (1) it's cleartext and therefore very good as a measure against vendor lock-in and (2) it has, to some extent, dampened the rampant "not-invented-here"-esqe tendency to use proprietary formats. Even in open-source apps, proprietary formats make it hard for non-dev users to get their stuff out. If it's markdown (or at least supports markdown export) from the beginning, at least you know you can take your data with you.
That GitHub used it as a "native" format everywhere from the beginning (as far as I remember), probably helped Markdown become at least as popular (or maybe even more) as GitHub itself.
Then everyone and their mother started doing static blogs, and since people already wrote their READMEs and issue comments with Markdown, I guess it was natural to want to write your blogposts with Markdown too, just like Gruber.
My company is on Teams and I regularly use Markdown in my messages, though I still struggle to remember that I have to use underscores not asterisks for italics.
As for Teams, it looks like it’s much closer to Markdown (uses the same idiosyncratic/stupid link syntax), but still significantly incompatible even if they call it that. And my guess (as a non-user) is that it’s just an input method immediately converted to HTML or similar, not retained as text. So in that way it’s not Markdown either.
It helps that Jekyll, one such static blog, was also pushed by GitHub back in the day.
Like with WordPerfect, there are people who get great utility (attorneys in WP, developers with Markdown), but 80-95% of people don’t get anything out of it.
It’s also one of those things where the constraints are an advantage. Markdown is great for internet facing text content, while many aspects of the mainstream wysiwyg editors are really descended from solutions for placing text on paper.
Just because I can’t fix my car doesn’t mean I want an unfixable car.
There’s no free lunch. On the flip, that user wants the complex features of the platform, and exposing them to a markup language takes elegant markdown and turns it into html or ooxml.
Lawyer here: I loved WordPerfect (for DOS) because of Reveal Codes and its easy keystroke macros, which let me write an Emacs keyboard emulator for it. (Yes, I eventually did one for Microsoft Word for Windows, which I use to this day.)
Related: https://news.ycombinator.com/item?id=10383691
Unfortunately there’s no realistic solution to the lock-in, so wrestling with broken paragraph formatting, mismatched text sizes, auto-numbering errors, etc at 2am before a client deadline remains the norm. One of the most frustrating parts of the job.
I write stories and everyone uses Word documents for editing.
I was on a project and complained heavily that we were not using styles,. The complaints got my manager to state that another person would do all the formatting. Of course the other person left befor the end and I had to do all the formatting.
Paste additions to the middle of a numbered list from legacy documents that break the number sequence and use custom fonts altar create weird problems? Sure.
Allow sociopaths to format text using a series of invisible text boxes? Sure.
Decide to randomly lose the names of editors and contributors? Sure.
Markdown is good enough for most of the documentation that software engineers do (other than diagrams), they already have to know it, and I don't want yet-another-markup-language to be a barrier to capturing and communicating institutional knowledge.
I also tell people that, if you're new to Markdown, even a plain text approximation that doesn't quite format correctly is strongly encouraged, so long as they capture the info somewhere accessible. I'll even offer to cheerfully fix the missing/bad Markdown, so that we have working docs and people can learn the very few parts of Markdown they missed; it's really not much.
(I personally have heavily used many much-much better technical documentation systems, and helped develop a WYSIWYG-ish SGML-based one professionally, but just using Markdown is a no-brainer right now. There are much more important things I want people learning and doing, than N different ways of minimally formatting documentation in N different places.)
Works fine with some help https://mermaid.live/ https://github.blog/developer-skills/github/include-diagrams...
So lists look exactly how you would expect lists to look like if you were writing it on a piece of paper.
Italic/Bolds are surrounded by /* which convey emphasis even in plaintext.
Headings prefixed by # is a reasonable way to depict headings in plaintext and convey the intention immediately even if you don't know Markdown.
Also covered by AsciiDoc.
"Compare AsciiDoc and Markdown": https://news.ycombinator.com/item?id=27744509
The rumors seem to indicate just "Export as Markdown", which seems to be exactly what Gruber wants, according to the last 10% of the blogpost. So the rest is ranting against an implementation that doesn't seem like it'll happen?
We have a tendency, as a group, to push things beyond their original intent.
Why not export to the best format, LaTeX? I don’t think anyone could argue that Markdown is better than LaTeX as long as you don’t actually have to write it.
I’m constantly sending URLs to people, like https://somesite.com/login. The point of these links is usually that people read them and understand them.
But the automatic behavior is to replace the text with OpenGraph links, big obnoxious bubbles of graphics, which distort or destroy the meaning that I’m trying to convey.
Given the opportunity, I would send most links wrapped in `backticks`.
System-wide Markdown editing would also be awesome, perhaps as a feature of the keyboard.
https://honeypot.net/2024/01/17/making-notes-look.html
[1]: https://freron.com
<yourlink.com> and it sends it as a regular link without the bubble
It's such a more convenient way of "styling while you type" and has become the de facto way to do that... in Slack, Reddit comments, GitHub, Jira, Confluence etc... even MS Teams, they all allow Markdown "styling while you type"
The two things that would make a world of difference to me are:
- having a 'code block' style, preferably accessed via familiar single and triple-backticks markdown syntax - for the Android app to have a "magnifying cursor" like mobile apps are all supposed to have... trying to edit a note and drag the cursor around with your finger without having the little magnifying popup is a complete pain
the effort it takes to serialize and parse markdown into an AST that rich text editor frameworks reliably operate on takes months. been there, done that. the majority of the engineering effort of building a markdown editor in the browser went into parsing and serializing markdown :/
Anyhow, we took the learnings from the Markdown editor app and created "zettel" as a result: https://github.com/opral/monorepo/tree/main/packages/zettel/.... The goal is to have an interoperable rich text AST—basically Markdown but with an AST spec.
The article pretends that Markdown got popular because “it was there”. 15 years ago people were adopting it _because_ it is dead simple, unobtrusive, and visually evocative.
The ones who made it popular, in other words, did so quite intentionally.
This will make it even easier to migrate all my Apple Notes™ to Obsidian.