{"id":14031,"date":"2021-09-20T10:47:59","date_gmt":"2021-09-20T08:47:59","guid":{"rendered":"https:\/\/dans.knaw.nl\/file-formats\/markup-language\/markdown\/"},"modified":"2025-01-24T12:40:55","modified_gmt":"2025-01-24T11:40:55","slug":"markdown","status":"publish","type":"page","link":"https:\/\/dans.knaw.nl\/en\/file-formats\/markup-language\/markdown\/","title":{"rendered":"Markdown"},"content":{"rendered":"

[et_pb_section fb_built=”1″ admin_label=”section” _builder_version=”3.22″ global_colors_info=”{}”][et_pb_row admin_label=”row” _builder_version=”3.25″ background_size=”initial” background_position=”top_left” background_repeat=”repeat” global_colors_info=”{}”][et_pb_column type=”4_4″ _builder_version=”3.25″ custom_padding=”|||” global_colors_info=”{}” custom_padding__hover=”|||”][et_pb_text admin_label=”Text” _builder_version=”4.10.7″ background_size=”initial” background_position=”top_left” background_repeat=”repeat” hover_enabled=”0″ global_colors_info=”{}” sticky_enabled=”0″]<\/p>\n

Markdown<\/h1>\n

Markdown is a lightweight markup language that is known for its simplicity and ease of use for writing structured documents. It was created in 2004 by John Gruber, with significant contributions from Aaron Swartz. Gruber wanted to create a plain-text format that could be easily converted to structurally valid HTML. His goal was to develop a syntax that was both human-readable and easy to write, as opposed to the verbose nature of HTML. The resulting Markdown consists of two components: a plain text formatting syntax, and a software tool that converts the plain text to HTML.\u00a0<\/span><\/p>\n

The first Markdown version was released as an open-source project and was quickly adopted by bloggers and people working with wikis. Today it is widely used by platforms like GitHub (as README files), Reddit, Stack Overflow, and Discord. Markdown’s readability and ease of use make it popular in a variety of domains, including web content creation, software documentation, note-taking and manuscript writing. It allows bloggers, journalists, developers and authors to create documents for the web without needing a deep understanding of HTML or CSS, as Markdown files can easily be converted into fully formatted documents.\u00a0<\/span><\/p>\n

While Markdown is widely used, there isn’t a universally accepted standard specification for its syntax. The exact implementation can differ across platforms and versions. Markdown parsers and implementations may interpret the same input differently, leading to potential difficulties when moving content across platforms or converting them into different formats. For example, certain Markdown features, such as code blocks, images and footnotes, may be rendered differently on Github versus a personal website using a different Markdown processor. Note that these rendering differences don\u2019t affect the content of the Markdown file, just the layout.\u00a0\u00a0<\/span><\/p>\n

Interpretations can also differ across different Markdown parsers. This has led to the development of slightly different Markdown syntax variations that you can refer to as flavors or dialects. The vast majority of the syntax will be the same across dialects, so don\u2019t worry about it too much. The dialects may differ in which features are supported (such as tables or math blocks), and may handle ambiguities differently. DANS accepts any markdown dialect.\u00a0<\/span><\/p>\n

A Markdown document can have a .md or .markdown extension.\u00a0<\/span><\/p>\n

Markdown is a preferred file format for file type <\/span>Markup Language<\/span><\/a>.<\/span><\/p>\n

 <\/p>\n

\u00a9 DANS. R.5.5.T.3.P.7 Version 1.0, January 17, 2025<\/span><\/pre>\n
[\/et_pb_text][\/et_pb_column][\/et_pb_row][\/et_pb_section]<\/p>\n","protected":false},"excerpt":{"rendered":"
Markdown Markdown is a lightweight markup language that is known for its simplicity and ease of use for writing structured documents. It was created in 2004 by John Gruber, with significant contributions from Aaron Swartz. Gruber wanted to create a plain-text format that could be easily converted to structurally valid HTML. His goal was to […]<\/p>\n","protected":false},"author":8,"featured_media":0,"parent":13056,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"_et_pb_use_builder":"on","_et_pb_old_content":"
Upcoming text language of the web, geared to plain text, but with basic formatting capabilities from\u00a0HTML; looks nice from the outside, looks good from the inside. Links:\u00a0Markdown<\/a><\/p>","_et_gb_content_width":"","inline_featured_image":false,"footnotes":""},"class_list":["post-14031","page","type-page","status-publish","hentry"],"acf":[],"yoast_head":"\nFile formats: Markdown | DANS<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/dans.knaw.nl\/en\/file-formats\/markup-language\/markdown\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"File formats: Markdown | DANS\" \/>\n<meta property=\"og:description\" content=\"Markdown Markdown is a lightweight markup language that is known for its simplicity and ease of use for writing structured documents. It was created in 2004 by John Gruber, with significant contributions from Aaron Swartz. Gruber wanted to create a plain-text format that could be easily converted to structurally valid HTML. His goal was to […]\" \/>\n<meta property=\"og:site_name\" content=\"DANS\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/Data-Archiving-and-Networked-Services-DANS-140231255994524\/\" \/>\n<meta property=\"article:modified_time\" content=\"2025-01-24T11:40:55+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:site\" content=\"@dans_knaw_nwo\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/dans.knaw.nl\\\/en\\\/file-formats\\\/markup-language\\\/markdown\\\/\",\"url\":\"https:\\\/\\\/dans.knaw.nl\\\/en\\\/file-formats\\\/markup-language\\\/markdown\\\/\",\"name\":\"File formats: Markdown | DANS\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/dans.knaw.nl\\\/en\\\/#website\"},\"datePublished\":\"2021-09-20T08:47:59+00:00\",\"dateModified\":\"2025-01-24T11:40:55+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/dans.knaw.nl\\\/en\\\/file-formats\\\/markup-language\\\/markdown\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/dans.knaw.nl\\\/en\\\/file-formats\\\/markup-language\\\/markdown\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/dans.knaw.nl\\\/en\\\/file-formats\\\/markup-language\\\/markdown\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/dans.knaw.nl\\\/en\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"File formats\",\"item\":\"https:\\\/\\\/dans.knaw.nl\\\/en\\\/file-formats\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Markup language\",\"item\":\"https:\\\/\\\/dans.knaw.nl\\\/en\\\/bestandsformaten\\\/opmaaktaal\\\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Markdown\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/dans.knaw.nl\\\/en\\\/#website\",\"url\":\"https:\\\/\\\/dans.knaw.nl\\\/en\\\/\",\"name\":\"DANS\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/dans.knaw.nl\\\/en\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"File formats: Markdown | DANS","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/dans.knaw.nl\/en\/file-formats\/markup-language\/markdown\/","og_locale":"en_US","og_type":"article","og_title":"File formats: Markdown | DANS","og_description":"Markdown Markdown is a lightweight markup language that is known for its simplicity and ease of use for writing structured documents. It was created in 2004 by John Gruber, with significant contributions from Aaron Swartz. Gruber wanted to create a plain-text format that could be easily converted to structurally valid HTML. His goal was to […]","og_site_name":"DANS","article_publisher":"https:\/\/www.facebook.com\/Data-Archiving-and-Networked-Services-DANS-140231255994524\/","article_modified_time":"2025-01-24T11:40:55+00:00","twitter_card":"summary_large_image","twitter_site":"@dans_knaw_nwo","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/dans.knaw.nl\/en\/file-formats\/markup-language\/markdown\/","url":"https:\/\/dans.knaw.nl\/en\/file-formats\/markup-language\/markdown\/","name":"File formats: Markdown | DANS","isPartOf":{"@id":"https:\/\/dans.knaw.nl\/en\/#website"},"datePublished":"2021-09-20T08:47:59+00:00","dateModified":"2025-01-24T11:40:55+00:00","breadcrumb":{"@id":"https:\/\/dans.knaw.nl\/en\/file-formats\/markup-language\/markdown\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/dans.knaw.nl\/en\/file-formats\/markup-language\/markdown\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/dans.knaw.nl\/en\/file-formats\/markup-language\/markdown\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/dans.knaw.nl\/en\/"},{"@type":"ListItem","position":2,"name":"File formats","item":"https:\/\/dans.knaw.nl\/en\/file-formats\/"},{"@type":"ListItem","position":3,"name":"Markup language","item":"https:\/\/dans.knaw.nl\/en\/bestandsformaten\/opmaaktaal\/"},{"@type":"ListItem","position":4,"name":"Markdown"}]},{"@type":"WebSite","@id":"https:\/\/dans.knaw.nl\/en\/#website","url":"https:\/\/dans.knaw.nl\/en\/","name":"DANS","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/dans.knaw.nl\/en\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/dans.knaw.nl\/en\/wp-json\/wp\/v2\/pages\/14031","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dans.knaw.nl\/en\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/dans.knaw.nl\/en\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/dans.knaw.nl\/en\/wp-json\/wp\/v2\/users\/8"}],"replies":[{"embeddable":true,"href":"https:\/\/dans.knaw.nl\/en\/wp-json\/wp\/v2\/comments?post=14031"}],"version-history":[{"count":2,"href":"https:\/\/dans.knaw.nl\/en\/wp-json\/wp\/v2\/pages\/14031\/revisions"}],"predecessor-version":[{"id":23182,"href":"https:\/\/dans.knaw.nl\/en\/wp-json\/wp\/v2\/pages\/14031\/revisions\/23182"}],"up":[{"embeddable":true,"href":"https:\/\/dans.knaw.nl\/en\/wp-json\/wp\/v2\/pages\/13056"}],"wp:attachment":[{"href":"https:\/\/dans.knaw.nl\/en\/wp-json\/wp\/v2\/media?parent=14031"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}