top 50 comments

sorted by: hot top controversial new old
[–] 142 points 3 years ago (10 children)

Whoever made Jira's markup syntax: Straight to jail.

  • source
  • hideshow 10 child comments
  • [–] 58 points 3 years ago (6 children)

    The thing I dislike most about Atlassian products is that each of them has a completely different formatting engine and markup syntax. You'd think they'd be consistent but noooo

  • source
  • parent
  • hideshow 6 child comments
  • [–] 22 points 3 years ago

    Atlassian doesn't even have consistency within single products! I'm using Jira Cloud at work, and while most fields support markdown (e.g. three backticks to start a code block) there are a few that only support Jira's own notation (e.g. {code} to start a code block). It's always infuriating when I type some markdown in one of the fields that doesn't support it for some inexplicable reason.

  • source
  • parent
  • [–] 67 points 3 years ago (5 children)
  • [–] 12 points 3 years ago (3 children)

    I've been having trouble getting syntax highlighting to work on my '```' fenced code blocks. I give it the right/supported language identifier, but nothing changes.

    I'm using neovim with a bunch of lsp plugins and treesitter. Anyone have dotfiles with markdown code syntax highlighting working?

  • source
  • parent
  • hideshow 3 child comments
  • load more comments (2 replies)
  • load more comments (1 reply)
    [–] 59 points 3 years ago (16 children)

    Discovering obsidian has been a blessing for my sanity and made me less lazy for taking notes.

    Plus I can use latex to transform md into docx and there's decent pdf support so I don't need to play with the circus of WYSIWYG pain that's MS Word.

  • source
  • hideshow 16 child comments
  • [–] 16 points 3 years ago* (3 children)

    I keep meaning to check out Obsidian, but I'm like you said, lazy.

  • source
  • parent
  • hideshow 3 child comments
  • [–] 12 points 3 years ago (4 children)

    I have obsidian installed, but I haven't really looked into how to use it. It has been on my list of things I should probably learn for a long time now

  • source
  • parent
  • hideshow 4 child comments
  • load more comments (5 replies)
    [–] 56 points 3 years ago (8 children)

    This is the way.

    Almost completely pure way of storing ideas. With this I mean that you don't store unnecessary data such as "background should be white" or "left page margin is 1.3cm". It's just text. What's important is what it says + minimal markup.

    Presentation is left to the reader's client. Do you want dark mode? Get a markdown editor/reader that supports it. Do you want serif font? Again, that's client's choice and not part of the document.

    I wish browsers would support markdown out of the box, so you could open https://example.com/some-post.md

  • source
  • hideshow 8 child comments
  • [–] 44 points 3 years ago (6 children)

    Old fart warning!

    Presentation is left to the reader's client. Do you want dark mode? Get a markdown editor/reader that supports it. Do you want serif font? Again, that's client's choice and not part of the document.

    I remember when that is how the web worked. All that markup was to define the structure of the document and the client rendered it as set by the user.

    Some clients were better than others. My favourite was the default browser in OS/2 Warp, which allowed me to easily set the display characteristics of every tag. The end result was that every site looked (approximately) the same, which made browsing so much nicer, in my opinion.

    Then someone decided that website creation should be part of the desktop publishing class (at least at the school I taught at). The world (wide web) has never recovered.

  • source
  • parent
  • hideshow 6 child comments
  • [–] 10 points 3 years ago (5 children)

    We're kinda getting it back with the Accessibility tree

    In theory, if the page is compiled right, you can read everything right from there. You could also interact with it.

  • source
  • parent
  • hideshow 5 child comments
  • [–] 9 points 3 years ago

    It's a simple and elegant way of covering 95% of document structuring needs, while being as close to readable plaintext as possible.

    The vast majority of documents currently written in MS-word could just be markdown. The vast majority of web content could just be markdown. This would save the modern world petabytes of XML bloat.

    If you need something fancier, either use a vector format or do fancy client-side styling.

  • source
  • parent
  • [–] 29 points 3 years ago* (3 children)

    Markdown is good. I use it when working in the company since the format is ubiquitous. I do writing my blog posts with Markdown (Hugo for the curious).

    But personally, or working with a bit more niche team, for writing personal documentation I prefer Asciidoc [0]. It has better syntax and have some nice functionalities like Table of Contents.

    For personal notes, nothing can surpass Org Mode [1].

    [0] https://asciidoc.org

    [1] https://orgmode.org

  • source
  • hideshow 3 child comments
  • load more comments (1 reply)
    [–] 28 points 3 years ago (8 children)

    Obsidian, md all the way down

  • source
  • hideshow 8 child comments
  • load more comments (2 replies)
    [–] 20 points 3 years ago (14 children)

    I was looking for a journaling app that didn't have vendor locking, or required some weird export dump that messed your formatting and folders up. That lead me to Markdown and Obsidian. I love it. And when I die, that shit will still be readable by any basic text editor.

  • source
  • hideshow 14 child comments
  • [–] 18 points 3 years ago (6 children)

    Wait until you learn about Org-mode.

  • source
  • hideshow 6 child comments
  • [–] 11 points 3 years ago (5 children)

    I’m vaguely aware of Org-mode but only as an alternative to Markdown. Last time I looked into it, though (years ago), Markdown seemed like a much better option for me for various reasons. Do you have a good argument for why Org-mode is a better choice for common use cases than the relatively universal GitHub-flavored Markdown?

  • source
  • parent
  • hideshow 5 child comments
  • [–] 7 points 3 years ago

    depending on what you do there are large benefits, for me they are executable code blocks (i.e. jupyter like experience) and way better latex support (if you type equations that are more involved this is rather important).

  • source
  • parent
  • load more comments (1 reply)
  • [–] 13 points 3 years ago

    Emacs gang here, coughing in org-mode.

  • source
  • [–] 12 points 3 years ago

    Could we convert this meme to markdown?

  • source
  • [–] 8 points 3 years ago (4 children)

    Where is that footage from?

  • source
  • hideshow 4 child comments
  • load more comments (2 replies)
    [–] 6 points 3 years ago

    .md files on

  • source
  • [–] 6 points 3 years ago
    [–] 6 points 3 years ago (1 child)

    Eh, while Markdown is nice I think Dokuwiki's syntax is infinitively better for any kind of text that ends up involving programming code. It also has a header syntax that makes sense, albeit rather cumbersome. And it also makes a proper distinction between italics and underline which are two different, standard typographical effects and not the same thing as Markdown seems to believe; and between ordered and unordered lists (let alone nested lists).

    Just about the only bad thing is I haven't been able to find an editor that supports it. Probably because, to my knowledge, no self-standing / independent renderer exists for it (the parser and renderer seem to be tightly integrated into the content manager).

  • source
  • hideshow 1 child comment
  • load more comments (1 reply)
    load more comments
    view more: next ›