4 ms·
In a case of hidden issues in plain sight; your first markdown example, speaks of what the # means but ignore the leading # being used to signifiy a header in m
by evolve2k 6y ago
In a case of hidden issues in plain sight; your first markdown example, speaks of what the # means but ignore the leading # being used to signifiy a header in markdown. Make sense to me as a coder, but I expect non-coders will be left confused as the # obviously does important things and yet there’s an extra one there that’s unexplained (that does header markup).
Consider removing the header all together for the sake of simplified grokking.
- anticristi 6y agoI'm a coder and I still struggle to "see through layers". Imagine seeing the following in Ansible: shell: > cat {{ item }} | grep ansible echo $USER with_items: - hello.txt - hello2.txt - hello3.txt You essentially look at 4 layers (YAML, Ansible, Jinja, Shell) and need to "run them in your brain" in the correct order.
- kemitchell 6y agoMy first paragraph mentions Markdown. My first link leads to https://type.commonform.org/ https://type.commonform.org/. Markdown first. Then Mustache on top of Markdown.
- evolve2k 6y agoI get that. Ask your non-coder mate to read the article over.. thinking it’s a tricky double logic point.. You’re teaching us about # but # has two meanings inside ur short example. My suggestion, let them learn about headings elsewhere and simplify your example. It’s not for real word use anyway. 2 cents. Nice article
- spiralx 6y agoHah, our legal document templates are a combination of Pug for document structure with features from Markdown for text formatting and Handlebars for variable formatting.