diff options
| author | Jonas Smedegaard <dr@jones.dk> | 2025-03-18 09:40:24 +0100 |
|---|---|---|
| committer | Jonas Smedegaard <dr@jones.dk> | 2025-03-18 09:40:24 +0100 |
| commit | 57dcb94ba9728def667799d3e81f59235259b33d (patch) | |
| tree | 78b34f75b0c76c421de4967227aeb3dd91ccfbb7 /_markdown.qmd | |
| parent | fa348679c737a06dd9c74caaab78a035abc89d16 (diff) | |
rename file markdown -> formats, and expand content
Diffstat (limited to '_markdown.qmd')
| -rw-r--r-- | _markdown.qmd | 48 |
1 files changed, 0 insertions, 48 deletions
diff --git a/_markdown.qmd b/_markdown.qmd deleted file mode 100644 index 56d4c76..0000000 --- a/_markdown.qmd +++ /dev/null @@ -1,48 +0,0 @@ -Markdown is a text markup language -with an emphasis on being easy for humans to read -[@Gruber2004]. - -Compared to word processors like Microsoft Word and LibreOffice Writer, -Markdown authoring stores both content and markup together -in a human-readable tekst file. - -::: {#fig-formality} - -``` -informal /---------formatted text----------\ formal -<------v-------------v-------------v-----------------------v----> - plain text informal markup formal markup binary format - (Markdown) (HTML, XML, etc.) -``` - -Markdown is informal, ASCII-based markup -[@Leonard2016, p. 4] - -::: - -HTML is itself a plaintext format, -but is less human-readable. -Similarly the format LaTeX is also plaintext, -but its markdown arguably distracts the reading process -[@Mailund2019chap2, p. 9]. - -## Alternatives - -Other human-readable document source formats exists. - -FIXME reStructuredText. -FIXME Org-mode. -FIXME AsciiDoc. - -## Integration - -Markdown is in widespread use. - -Major source forges use Markdown by default for `README` files -[@Github2025; @GitLab2025; @Codeberg2024]. -Some major programming languages -natively support Markdown in embedded docstrings -in core tools -[@Microsoft2023; @Oracle2025; @RustTeam2024]; -others offer optional support e.g. through plugins -[@Heesch2025; @Sphinx2025; @JSDoc2023]. |
