Whoever made Jira’s markup syntax: Straight to jail.
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
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. {} 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.
In Confluence… the same emojis look different on page title on the sidebar vs the body. Two different font families.
It’s incredible.
Thankfully these days I spend most of my time in Confluence, which supports Markdown
Code? .md files on GitHub
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?
Have you installed the treeesitter grammars for those languages with :TSInstall language_name or in your treesitter config?
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.
Hi. This is your push to do it.
Download it and start a video tutorial of your choosing.
It’s great! Do it!
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
I am probably just an idiot but i find writing proper notes with links etc very tedious, in obsidian.
So i end uo just typing everything into a few documents based on the doc title. Which means i might as well just use notepad
Sounds like you need to check out Org-roam (if you use emacs) or some other zettelkasten style note taking software
I think the use cases are different, as Zettlr seems like a pure publication tool but Obsidian (at least originally) was more of a personal note organizer that grew due to having community plugins.
I do agree though that Zettlr is a better publication tool, though I wouldn’t change Obsidian for it as a personal organizer/kb.
Obsidian is what I used to keep my notes while playing Book of Hours. It was a fantastic tool and I’ll definitely use it in the future!
How’s the Book of Hours? I played a good deal of Cultist Simulator, but it tends to suck me in and I recover few hours later without an understanding what just happened.
I finished my playthrough a couple days ago, after 80 hours. It’s much more forgiving than CS – there’s no lose condition, as far as I can tell. There’s also a shitload more to keep track of, hence me using Obsidian. I personally found the experience of tracking [what books give what resource] and [what resources make what crafting recipes] to be extremely satisfying, but your mileage may vary.
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
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.
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.
Thanks. This is the first I’ve heard of the Accessibility tree. A quick look kind of spooked me, but I’ll dig deeper.
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.
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].
