{"id":14980793,"url":"https://github.com/witiko/markdown","last_synced_at":"2025-10-02T20:32:10.095Z","repository":{"id":37484548,"uuid":"55950502","full_name":"Witiko/markdown","owner":"Witiko","description":":notebook_with_decorative_cover: A package for converting and rendering markdown documents in TeX","archived":false,"fork":true,"pushed_at":"2024-10-29T12:11:32.000Z","size":9910,"stargazers_count":330,"open_issues_count":17,"forks_count":31,"subscribers_count":8,"default_branch":"main","last_synced_at":"2024-10-29T13:28:40.213Z","etag":null,"topics":["context","latex","latex-package","lua","lualatex","luametatex","luatex","markdown","markdown-parser","tex"],"latest_commit_sha":null,"homepage":"http://ctan.org/pkg/markdown","language":"TeX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"jgm/lunamark","license":"lppl-1.3c","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Witiko.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2016-04-11T07:20:28.000Z","updated_at":"2024-10-29T12:11:36.000Z","dependencies_parsed_at":"2023-09-27T15:29:36.647Z","dependency_job_id":null,"html_url":"https://github.com/Witiko/markdown","commit_stats":null,"previous_names":[],"tags_count":84,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Witiko%2Fmarkdown","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Witiko%2Fmarkdown/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Witiko%2Fmarkdown/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Witiko%2Fmarkdown/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Witiko","download_url":"https://codeload.github.com/Witiko/markdown/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235043592,"owners_count":18927006,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["context","latex","latex-package","lua","lualatex","luametatex","luatex","markdown","markdown-parser","tex"],"created_at":"2024-09-24T14:02:24.967Z","updated_at":"2025-10-02T20:32:10.088Z","avatar_url":"https://github.com/Witiko.png","language":"TeX","readme":"The Markdown Package for TeX\n============================\n\n[![license](https://img.shields.io/github/license/witiko/markdown)](LICENSE)\n[![ci](https://github.com/witiko/markdown/actions/workflows/main.yml/badge.svg)][ci]\n[![release](https://img.shields.io/github/release/witiko/markdown)][release]\n[![docker-witiko/markdown](https://img.shields.io/docker/v/witiko/markdown/latest?label=docker)][docker-witiko/markdown]\n[![matrix](https://img.shields.io/matrix/witiko-markdown:matrix.org?label=matrix)][matrix]\n[![discord](https://img.shields.io/discord/1011667276908474440?label=discord\u0026color=blueviolet)][discord]\n[![chatgpt](https://img.shields.io/badge/gpt-9cf)][chatgpt]\n\n [release]:  https://github.com/Witiko/markdown/releases/latest              \"Releases · Witiko/markdown\"\n [ci]:       https://github.com/Witiko/markdown/actions                      \"GitHub Actions\"\n [matrix]:   https://matrix.to/#/#witiko-markdown:matrix.org                 \"The Matrix Chat Space for the Markdown package\"\n [discord]:  https://discord.gg/8xJsPghzSH                                   \"The Discord Chat Space for the Markdown package\"\n [chatgpt]:  https://chat.openai.com/g/g-I3K0DweJe-markdown-package-for-tex  \"ChatGPT - Markdown package for TeX\"\n\nThe Markdown package converts [CommonMark][] markup to TeX commands. The\nfunctionality is provided both as a Lua module, and as plain TeX, LaTeX, and\nConTeXt macro packages that can be used to directly typeset TeX documents\ncontaining markdown markup. Unlike other converters, the Markdown package does\nnot require any external programs, and makes it easy to redefine how each and\nevery markdown element is rendered. Creative abuse of the markdown syntax is\nencouraged. 😉\n\n [commonmark]: https://commonmark.org/ \"CommonMark: A strongly defined, highly compatible specification of Markdown\"\n\nYour first markdown document\n----------------------------\n\nUsing a text editor, create an empty directory named `workdir/`. In it, create\na text document named `workdir/document.tex` with the following content:\n\n``` latex\n\\documentclass{book}\n\\usepackage{markdown}\n\\markdownSetup{pipeTables,tableCaptions}\n\\begin{document}\n\\begin{markdown}\nIntroduction\n============\n## Section\n### Subsection\nHello *Markdown*!\n\n| Right | Left | Default | Center |\n|------:|:-----|---------|:------:|\n|   12  |  12  |    12   |    12  |\n|  123  |  123 |   123   |   123  |\n|    1  |    1 |     1   |     1  |\n\n: Table\n\\end{markdown}\n\\end{document}\n```\n\nNext, run the [LaTeXMK][] tool from\n[our official Docker image][docker-witiko/markdown] on `document.tex`:\n\n    docker run --rm -v \"$PWD\"/workdir:/workdir -w /workdir witiko/markdown \\\n      latexmk -pdf -shell-escape -silent document.tex\n\nAlternatively, you can install [TeX Live][tex-live] (can take up to several\nhours) and use its [LaTeXMK][] tool:\n\n    latexmk -cd -pdf -shell-escape -silent workdir/document.tex\n\nA PDF document named `workdir/document.pdf` should be produced and contain the\nfollowing output:\n\n ![banner](markdown.png \"An example LaTeX document using the Markdown package\")\n\nCongratulations, you have just typeset your first Markdown document! 🥳\n\n [tex-live]: https://www.tug.org/texlive/ \"TeX Live - TeX Users Group\"\n\nUse markdown for continuous integration\n---------------------------------------\n\nCan't live without the latest features of the Markdown package in your\ncontinuous integration pipelines? It's ok, you can use\n[our official Docker image][docker-witiko/markdown] as a drop-in replacement\nfor [the `texlive/texlive:latest` Docker image][docker-texlive/texlive]!\nThe following example shows a [GitHub Actions][github-actions] pipeline, which\nwill automatically typeset and prerelease a PDF document:\n\n``` yaml\nname: Typeset and prerelease the book\non:\n  push:\njobs:\n  typeset:\n    runs-on: ubuntu-latest\n    container:\n      image: witiko/markdown:latest\n    steps:\n      - uses: actions/checkout@v4\n      - run: latexmk -lualatex document.tex\n      - uses: marvinpinto/action-automatic-releases@latest\n        permissions:\n          contents: write\n        with:\n          title: The latest typeset book\n          automatic_release_tag: latest\n          prerelease: true\n          repo_token: ${{ secrets.GITHUB_TOKEN }}\n          files: document.pdf\n```\n\nIn fact, this is how we automatically produce\n[the latest documentation][techdoc-latest] for the Markdown package.\n\n [docker-witiko/markdown]: https://hub.docker.com/r/witiko/markdown/tags \"witiko/markdown - Docker Image\"\n [docker-texlive/texlive]: https://hub.docker.com/r/texlive/texlive/tags \"texlive/texlive - Docker Image\"\n\n [github-actions]: https://docs.github.com/actions \"GitHub Actions Documentation\"\n\nFurther information\n-------------------\n\nFor further information, consult one of the following:\n\n1. The user manual for either [the released version][manual-tex-live] or\n   [the latest development version][manual-latest], which can be produced by\n   interpreting the `markdown.ins` file using a Unicode-aware TeX engine, such\n   as LuaTeX (`luatex markdown.ins`). The manual will reside in the file\n   `markdown.md` and the CSS stylesheet `markdown.css`.\n2. The technical documentation for either [the released version][techdoc-tex-live]\n   or [the latest development version][techdoc-latest], which can be typeset by\n   running the [LaTeXMK][] tool on the `markdown.dtx` file (`latexmk\n   markdown.dtx`) after [installing the Markdown package][install].\n   [LaTeXMK][] should be included in your TeX distribution.\n   The typeset documentation will reside in the file `markdown.pdf`.\n3. Tutorials and example documents by [Lian Tze Lim][liantze] at [Overleaf][]:\n    - [How to write in Markdown on Overleaf][overleaf-1],\n    - [Markdown into LaTeX with Style][overleaf-2],\n    - [Writing Markdown in LaTeX Documents][overleaf-3],\n    - [Writing Beamer Slides with Markdown][overleaf-4],\n    - [Writing Posters with Markdown][overleaf-5], and\n    - [Using Markdown in LaTeX documents][overleaf-6].\n4. Journal articles published by [TUGboat][]:\n    - [Using Markdown Inside TeX Documents][tb119],\n    - [Markdown 2.7.0: Towards Lightweight markup in TeX][tb124],\n    - [Making Markdown into a Microwave Meal][tb129],\n    - [Markdown 2.10.0: LaTeX Themes \u0026 Snippets, Two Flavors of Comments, and LuaMetaTeX][tb131],\n    - [Markdown 2.15.0: What's New?][tb133],\n    - [Markdown 2.17.1: What's New, What's Next?][tb135],\n    - [Attributes in Markdown][tb136],\n    - [Markdown 3 at TUG 2023: Reflections from the Q\u0026A Session][tb138],\n    - [Fast Regression Testing of TeX Packages: Multiprocessing and Batching][tb139],\n    - [Markdown Themes in Practice][tb140], and\n    - Piping YAML files into LaTeX3 key–values ([preprint][tb142-preprint]).\n5. Journal articles published by [CSTUG Bulletin][csbul] (in Czech and Slovak):\n    - [Rendering Markdown inside TeX Documents][10.5300/2016-1-4/78],\n    - [Markdown 2.8.1: Boldly Unto the Throne of Lightweight Markup in TeX][10.5300/2020-1-2/48],\n    - [Markdown 2.10.0: LaTeX Themes \u0026 Snippets][10.5300/2021-1-4/76],\n    - [Direct Typesetting of Various Document Formats in TeX Using the Pandoc Utility][10.5300/2021-1-4/83],\n    - [High-Level Languages for TeX][10.5300/2022-1-4/35], and\n    - [Markdown 3: What's New, What's Next?][10.5300/2023-3-4/111].\n6. Talks:\n    - [Five Years of Markdown in LaTeX: What, Why, How, and Whereto][pv212-fall2020] (in Czech),\n    - [Markdown 2.10.0: LaTeX Themes \u0026 Snippets, Two Flavors of Comments, and LuaMetaTeX][tb131-video] ([mirror][tb131-video-mirror], [slides][tb131-slides]),\n    - [A Self-Publisher's Take on Markdown and TeX][tb134-01-video] ([slides][tb134-01-slides]),\n    - [A Gentle Introduction to Markdown for Writers][tb134-02-video] ([slides][tb134-02-slides], [example][tb134-02-example]),\n    - [Markdown 3: What's New, What's Next?][tb137-video] ([mirror][tb137-video-mirror], [slides][tb137-slides]),\n    - An Implementation of the CommonMark Standard and new Syntax Extensions to the Markdown Package for TeX ([slides][gencur-defense-slides]), and\n    - [Markdown Themes in Practice][tb140-video] ([preprint][tb140-preprint], [slides][tb140-slides])\n7. Theses:\n    - [Generic TeX Writer for the Pandoc Document Converter][thesis-umhg5]\n    - [An implementation of the CommonMark standard into the Markdown package for TeX][thesis-r7z7l]\n\n [overleaf-1]: https://www.overleaf.com/learn/latex/Articles/How_to_write_in_Markdown_on_Overleaf       \"How to write in Markdown on Overleaf\"\n [overleaf-2]: https://www.overleaf.com/learn/latex/Articles/Markdown_into_LaTeX_with_Style             \"Markdown into LaTeX with Style\"\n [overleaf-3]: https://www.overleaf.com/learn/how-to/Writing_Markdown_in_LaTeX_Documents                \"Writing Markdown in LaTeX Documents\"\n [overleaf-4]: https://www.overleaf.com/latex/examples/writing-beamer-slides-with-markdown/dnrwnjrpjjhw \"Writing Beamer Slides with Markdown\"\n [overleaf-5]: https://www.overleaf.com/latex/examples/writing-posters-with-markdown/jtbgmmgqrqmh       \"Writing Posters with Markdown\"\n [overleaf-6]: https://www.overleaf.com/latex/examples/using-markdown-in-latex-documents/whdrnpcpnwrm   \"Using Markdown in LaTeX documents\"\n\n [tb119]: https://www.tug.org/TUGboat/tb38-2/tb119novotny.pdf                      \"Using Markdown inside TeX documents\"\n [tb124]: https://www.tug.org/TUGboat/tb40-1/tb124novotny-markdown.pdf             \"Markdown 2.7.0: Towards lightweight markup in TeX\"\n [tb129]: https://www.tug.org/TUGboat/tb41-3/tb129novotny-frozen.pdf               \"Making Markdown into a Microwave Meal\"\n [tb131]: https://www.tug.org/TUGboat/tb42-2/tb131novotny-markdown.pdf             \"Markdown 2.10.0: LaTeX Themes \u0026 Snippets, Two Flavors of Comments, and LuaMetaTeX\"\n [tb133]: https://www.tug.org/TUGboat/tb43-1/tb133novotny-markdown.pdf             \"Markdown 2.15.0: What's New?\"\n [tb135]: https://www.tug.org/TUGboat/tb43-3/tb135novotny-markdown.pdf             \"Markdown 2.17.1: What's New, What's Next?\"\n [tb136]: https://www.tug.org/TUGboat/tb44-1/tb136novotny-markdown-attr.pdf        \"Attributes in Markdown\"\n [tb138]: https://www.tug.org/TUGboat/tb44-3/tb138starynovotny-markdown-qa.pdf     \"Markdown 3 at TUG 2023: Reflections from the Q\u0026A session\"\n [tb139]: https://www.tug.org/TUGboat/tb45-1/tb139starynovotny-testing.pdf         \"Fast Regression Testing of TeX Packages: The Unreasonable Effectiveness of Batching\"\n [tb140]: https://www.tug.org/TUGboat/tb45-2/tb140starynovotny-markdown-themes.pdf \"Markdown Themes in Practice\"\n\n [tb142-preprint]: https://www.overleaf.com/read/gbtmtybxhnjj \"Piping YAML files into LaTeX3 key–values\"\n\n [tb131-slides]:       https://tug.org/tug2021/assets/pdf/tug2021-novotny-slides.pdf                            \"Markdown 2.10.0: LaTeX Themes \u0026 Snippets, Two Flavors of Comments, and LuaMetaTeX\"\n [tb131-video]:        https://youtu.be/i2GJMnLCZls                                                             \"Markdown 2.10.0: LaTeX Themes \u0026 Snippets, Two Flavors of Comments, and LuaMetaTeX\"\n [tb131-video-mirror]: https://youtu.be/THmPkAncMnc                                                             \"Markdown 2.10.0: LaTeX Themes \u0026 Snippets, Two Flavors of Comments, and LuaMetaTeX (mirror)\"\n [tb134-01-slides]:    https://tug.org/tug2022/assets/served/Lloyd_Prentice-TUG2022-prentice-selfpub-slides.pdf \"A Self-Publisher's Take on Markdown and TeX\"\n [tb134-01-video]:     https://youtu.be/OhwzT3TcLj8                                                             \"A Self-Publisher's Take on Markdown and TeX\"\n [tb134-02-slides]:    https://tug.org/tug2022/assets/pdf/Tereza_Vrabcová-TUG2022-slides.pdf                    \"A Gentle Introduction to Markdown for Writers\"\n [tb134-02-example]:   https://tug.org/tug2022/assets/pdf/Tereza_Vrabcová-TUG2022-example.pdf                   \"A Gentle Introduction to Markdown for Writers\"\n [tb134-02-video]:     https://youtu.be/FhN_x9rsR4M                                                             \"A Gentle Introduction to Markdown for Writers\"\n [tb137-slides]:       https://tug.org/tug2023/files/sa-03-novotny-markdown3/novotny-markdown3-slides.pdf       \"Markdown 3: What's New, What's Next?\"\n [tb137-video]:        https://youtu.be/U8XjTOhJkg0                                                             \"Markdown 3: What's New, What's Next?\"\n [tb137-video-mirror]: https://youtu.be/W15bBpVTA-c                                                             \"Markdown 3: What's New, What's Next? (mirror)\"\n [tb140-preprint]:     https://www.tug.org/tug2024/preprints/starynovotny-markdown-themes.pdf                   \"Markdown Themes in Practice\"\n [tb140-video]:        https://youtu.be/d7vTW7PR0B4?t=5h3m10s                                                   \"Markdown Themes in Practice\"\n [tb140-slides]:       https://www.tug.org/tug2024/slides/starynovotny-markdown-themes.pdf                      \"Markdown Themes in Practice\"\n\n [10.5300/2016-1-4/78]:  https://www.doi.org/10.5300/2016-1-4/78  \"Rendering Markdown inside TeX Documents\"\n [10.5300/2020-1-2/48]:  https://www.doi.org/10.5300/2020-1-2/48  \"Markdown 2.8.1: Boldly Unto the Throne of Lightweight Markup in TeX\"\n [10.5300/2021-1-4/76]:  https://www.doi.org/10.5300/2021-1-4/76  \"Markdown 2.10.0: LaTeX Themes \u0026 Snippets\"\n [10.5300/2021-1-4/83]:  https://www.doi.org/10.5300/2021-1-4/83  \"Direct Typesetting of Various Document Formats in TeX Using the Pandoc Utility\"\n [10.5300/2022-1-4/35]:  https://www.doi.org/10.5300/2022-1-4/35  \"High-Level Languages for TeX\"\n\n [10.5300/2023-3-4/111]: https://www.doi.org/10.5300/2023-3-4/111 \"Markdown 3: What's New, What's Next?\"\n\n [pv212-fall2020]: https://is.muni.cz/elearning/io/?qurl=%2Fel%2Ffi%2Fpodzim2020%2FPV212%2Findex.qwarp;prejit=5595952\n\n [gencur-defense-slides]: https://docs.google.com/presentation/d/e/2PACX-1vRbgJZ-UJlj5WMOjgWnq0BeNWKdA9ZhFqCKajhCjXtv3OarSKmojl5-X8tDp1ivnKtujuyEDmD2z_Z0/pub \"An Implementation of the CommonMark Standard and new Syntax Extensions to the Markdown Package for TeX\"\n\n [install]:  https://mirrors.ctan.org/macros/generic/markdown/markdown.html#installation \"Markdown Package User Manual\"\n [liantze]:  http://liantze.penguinattack.org/                                           \"Rants from the Lab\"\n [overleaf]: https://www.overleaf.com/                                                   \"Overleaf: Real-time Collaborative Writing and Publishing Tools with Integrated PDF Preview\"\n [tugboat]:  https://www.tug.org/tugboat/                                                \"TUGboat - Communications of the TeX Users Group\"\n [csbul]:    https://bulletin.cstug.cz/                                                  \"Zpravodaj Československého sdružení uživatelů TeXu\"\n\n [manual-latest]:     https://witiko.github.io/markdown                                  \"Markdown Package User Manual\"\n [manual-tex-live]:   https://mirrors.ctan.org/macros/generic/markdown/markdown.html     \"Markdown Package User Manual\"\n\n [techdoc-latest]:    https://github.com/Witiko/markdown/releases/download/latest/markdown.pdf  \"A Markdown Interpreter for TeX\"\n [techdoc-tex-live]:  https://mirrors.ctan.org/macros/generic/markdown/markdown.pdf             \"A Markdown Interpreter for TeX\"\n\n [thesis-umhg5]: https://is.muni.cz/th/umhg5/?lang=en \"Generic TeX Writer for the Pandoc Document Converter\"\n [thesis-r7z7l]: https://is.muni.cz/th/r7z7l/?lang=en \"An implementation of the CommonMark standard into the Markdown package for TeX\"\n\nAcknowledgements\n----------------\n\n| Logo          | Acknowledgement |\n| ------------- | --------------- |\n| [\u003cimg width=\"150\" src=\"https://www.fi.muni.cz/images/fi-logo.png\"\u003e][fimu] | I gratefully acknowledge the funding from the [Faculty of Informatics][fimu] at the [Masaryk University][mu] in Brno, Czech Republic, for the development of the Markdown package in projects [MUNI/33/12/2015][], [MUNI/33/1784/2020][], [MUNI/33/0776/2021][], [MUNI/33/1654/2022][], and [MUNI/33/1658/2022][]. |\n| [\u003cimg width=\"150\" src=\"https://cdn.overleaf.com/img/ol-brand/overleaf_og_logo.png\"\u003e][overleaf] | Extensive user documentation for the Markdown package was kindly written by [Lian Tze Lim][liantze] and published by [Overleaf][]. |\n| [\u003cimg width=\"150\" src=\"https://pbs.twimg.com/profile_images/1004769879319334912/6Bh1UthD.jpg\"\u003e][omedym] | Support for content slicing (Lua options [`shiftHeadings`][option-shift-headings] and [`slice`][option-slice]) and pipe tables (Lua options [`pipeTables`][option-pipe-tables] and [`tableCaptions`][option-table-captions]) was graciously sponsored by [David Vins][dvins] and [Omedym][]. |\n| [\u003cimg width=\"150\" src=\"https://github.com/istqborg/istqb_product_base/blob/main/img/istqb-logo-default.png\"\u003e][istqb] | Fixes for issues [#359][issue-359], [#368][issue-368], [#401][issue-401], [#424][issue-424], [#440][issue-440], [#468][issue-468], [#474][issue-474], and [#487][issue-487] were graciously sponsored by the [International Software Testing Qualifications Board (ISTQB)][istqb]. |\n\n [dvins]:  https://github.com/dvins             \"David Vins\"\n [fimu]:   https://www.fi.muni.cz/index.html.en \"Faculty of Informatics, Masaryk University\"\n [ISTQB]:  https://github.com/istqborg          \"ISTQB.ORG: Official ISTQB® GitHub account\"\n [mu]:     https://www.muni.cz/en               \"Masaryk University\"\n [Omedym]: https://www.omedym.com/              \"Omedym\"\n\n [issue-359]: https://github.com/witiko/markdown/issues/359 \"First item of a fancy list forms a separate list\"\n [issue-368]: https://github.com/witiko/markdown/issues/368 \"Tables nested in list items have empty lines\"\n [issue-401]: https://github.com/witiko/markdown/issues/401 \"Create an unnumbered section\"\n [issue-424]: https://github.com/witiko/markdown/issues/424 \"E-mail addresses are incorrectly interpreted as bracketed citations\"\n [issue-440]: https://github.com/witiko/markdown/issues/440 \"Support programmatic text in YAML metadata values\"\n [issue-468]: https://github.com/witiko/markdown/issues/468 \"Enable option eagerCache by default\"\n [issue-474]: https://github.com/witiko/markdown/issues/474 \"Improve the speed of the Markdown package\"\n [issue-487]: https://github.com/witiko/markdown/issues/487 \"Prevent loading the full Markdown package when converting cached markdown fragments\"\n\n [option-pipe-tables]:    https://mirrors.ctan.org/macros/generic/markdown/markdown.html#pipe-tables          \"Markdown Package User Manual\"\n [option-shift-headings]: https://mirrors.ctan.org/macros/generic/markdown/markdown.html#option-shiftheadings \"Markdown Package User Manual\"\n [option-slice]:          https://mirrors.ctan.org/macros/generic/markdown/markdown.html#slice                \"Markdown Package User Manual\"\n [option-table-captions]: https://mirrors.ctan.org/macros/generic/markdown/markdown.html#option-tablecaptions \"Markdown Package User Manual\"\n\n [MUNI/33/12/2015]:   https://www.muni.cz/en/research/projects/32984 \"A Markdown Interpreter in TeX\"\n [MUNI/33/1784/2020]: https://www.muni.cz/en/research/projects/58488 \"Extension of the Input Formats of the Markdown Tool\"\n [MUNI/33/0776/2021]: https://www.muni.cz/en/research/projects/62168 \"Preparation of Templates for Typesetting Books and Publishing Collaterals with the Markdown TeX Package\"\n [MUNI/33/1654/2022]: https://www.muni.cz/en/research/projects/69763 \"An Implementation of the CommonMark Standard into the Markdown Package for TeX\"\n [MUNI/33/1658/2022]: https://www.muni.cz/en/research/projects/69762 \"Syntax Extensions of the Markdown Package for TeX\"\n\nContributing to the development of markdown\n-------------------------------------------\n\nApart from the example markdown documents, tests, and continuous integration,\nwhich are placed in the `examples/`, `tests/`, and `.github/` directories,\nthe complete source code and documentation of the package are placed in the\n`markdown.dtx` document following the [literate programming][] paradigm.\nSome useful commands, such as building the release archives and typesetting\nthe documentation, are placed in the `Makefile` file for ease of maintenance.\n\nWhen the file `markdown.ins` is interpreted using a Unicode-aware TeX engine,\nsuch LuaTeX (`luatex markdown.ins`), several files are produced from the\n`markdown.dtx` document. The `make base` command is provided by `Makefile` for\nconvenience. In `markdown.dtx`, the boundaries between the produced files are\nmarked up using an XML-like syntax provided by the [l3docstrip][] plain TeX\npackage.\n\nRunning the [LaTeXMK][] tool on the `markdown.dtx` file\n(`latexmk markdown.dtx`) after the Markdown package has been\n[installed][install] typesets the documentation. The `make markdown.pdf`\ncommand is provided by `Makefile` for convenience. In `markdown.dtx`, the\ndocumentation is placed inside TeX comments and marked up using the\n[ltxdockit][] LaTeX document class. Support for typesetting the documentation\nis provided by the [doc][] LaTeX package.\n\nTo facilitate continuous integration and sharing of the Markdown package,\nthere exists an [official Docker image][docker-witiko/markdown], which can be\nreproduced by running the `docker build` command on `Dockerfile` (`docker build\n-t witiko/markdown .`). The `make docker-image` command is provided by\n`Makefile` for convenience.\n\n [doc]:                  https://ctan.org/pkg/doc                           \"doc – Format LaTeX documentation\"\n [l3docstrip]:           https://ctan.org/pkg/l3docstrip                    \"l3docstrip – Strip documentation in LaTeX3 source\"\n [LaTeXMK]:              https://ctan.org/pkg/latexmk                       \"latexmk – Fully automated LaTeX document generation\"\n [literate programming]: https://en.wikipedia.org/wiki/Literate_programming \"Literate programming\"\n [ltxdockit]:            https://ctan.org/pkg/ltxdockit                     \"ltxdockit – Documentation support\"\n\nRelated work\n------------\n\nLinks to third-party software for the Markdown package are available in the\n`contributions/` directory. The intention is to show interesting tools for the\nMarkdown package and to give them wider exposure without taking responsibility\nfor their development or maintenance.\n\nArtwork for the Markdown package is available in the `artwork/` directory.\nYou are welcome to use these artworks in your promotional materials, provided\nyou comply with the license terms specified for each piece. Typically, proper\nattribution to the artist is required.\n\nCiting markdown\n---------------\n\nWhen citing Markdown in academic papers and theses, please use the following\nBibTeX entry:\n\n``` bib\n@article{novotny2017markdown,\n  author  = {V\\'{i}t Novotn\\'{y}},\n  year    = {2017},\n  title   = {Using {M}arkdown Inside {\\TeX} Documents},\n  journal = {TUGboat},\n  volume  = {38},\n  number  = {2},\n  pages   = {214--217},\n  issn    = {0896-3207},\n  url     = {https://tug.org/TUGboat/tb38-2/tb119novotny.pdf},\n  urldate = {2020-07-31},\n}\n```\n\nAlternatively, you can use the `Novotny:2017:UMI` key from the [`tugboat.bib`][tugboat.bib]\nBibTeX file that is included in your TeX distribution like this:\n\n``` tex\n\\cite{Novotny:2017:UMI}\n\\bibliography{tugboat}\n```\n\n [tugboat.bib]: http://mirrors.ctan.org/info/digests/tugboat/biblio/tugboat.bib\n\nNotes to distributors\n---------------------\n\nThe file `markdown2tex.lua` should be installed in the TDS directory\n`scripts/markdown`. Furthermore, it should be made executable and either\nsymlinked to system directories as `markdown2tex` on Unix or have a wrapper\n`markdown2tex.exe` installed on Windows.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwitiko%2Fmarkdown","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwitiko%2Fmarkdown","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwitiko%2Fmarkdown/lists"}