{"meta":{"name":"FindSoftware","page":"https://findsoftware.frbit.cloud/mdoc/","markdown":"https://findsoftware.frbit.cloud/mdoc.md","license":"https://creativecommons.org/licenses/by/4.0/","attribution":"FindSoftware, CC BY 4.0","note":"Attributes are recorded, never scored. An absent field means unknown, never zero and never bad."},"record":{"id":"mdoc","name":"mdoc","urls":{"home":"https://scalameta.org/mdoc/","repository":"https://github.com/scalameta/mdoc","docs":"https://scalameta.org/mdoc/docs/installation.html"},"category":["ssg"],"description":"Markdown documentation tool for Scala that compiles and evaluates the Scala code blocks in markdown sources.","maintainer":"mdoc developers","maintainerType":"community","firstRelease":2018,"language":"scala","runtime":["jvm"],"runtimeMin":"jvm 11","runsAs":["local"],"installMethod":"sbt plugin sbt-mdoc","licenseModel":"open-source","license":"Apache-2.0","currentMajor":"2","latestReleaseDate":"2026-09-03T00:00:00.000Z","githubStargazers":402,"contributors":52,"packagistDownloads":null,"npmWeeklyDownloads":null,"social":{"discord":"https://discord.gg/FN9uG7k"},"checkedAt":"2026-10-23T00:00:00.000Z","addedAt":"2026-10-23T00:00:00.000Z","sources":[{"field":"urls","url":"https://scalameta.org/mdoc/","checkedAt":"2026-10-23T00:00:00.000Z"},{"field":"urls","url":"https://api.github.com/repos/scalameta/mdoc","checkedAt":"2026-10-23T00:00:00.000Z"},{"field":"urls","url":"https://scalameta.org/mdoc/docs/installation.html","checkedAt":"2026-10-23T00:00:00.000Z"},{"field":"maintainer","url":"https://scalameta.org/mdoc/","checkedAt":"2026-10-23T00:00:00.000Z"},{"field":"category","url":"https://github.com/scalameta/mdoc/blob/main/readme.md","checkedAt":"2026-10-23T00:00:00.000Z"},{"field":"runtime","url":"https://github.com/scalameta/mdoc/blob/main/readme.md","checkedAt":"2026-10-23T00:00:00.000Z"},{"field":"runtimeMin","url":"https://github.com/scalameta/mdoc/blob/main/readme.md","checkedAt":"2026-10-23T00:00:00.000Z"},{"field":"installMethod","url":"https://scalameta.org/mdoc/docs/installation.html","checkedAt":"2026-10-23T00:00:00.000Z"},{"field":"installMethod","url":"https://scalameta.org/mdoc/docs/installation.html","checkedAt":"2026-10-23T00:00:00.000Z"},{"field":"installMethod","url":"https://scalameta.org/mdoc/docs/installation.html","checkedAt":"2026-10-23T00:00:00.000Z"},{"field":"license","url":"https://api.github.com/repos/scalameta/mdoc","checkedAt":"2026-10-23T00:00:00.000Z"},{"field":"license","url":"https://github.com/scalameta/mdoc/blob/main/LICENCE.md","checkedAt":"2026-10-23T00:00:00.000Z"},{"field":"licenseModel","url":"https://github.com/scalameta/mdoc/blob/main/LICENCE.md","checkedAt":"2026-10-23T00:00:00.000Z"},{"field":"currentMajor","url":"https://api.github.com/repos/scalameta/mdoc/releases/latest","checkedAt":"2026-10-23T00:00:00.000Z"},{"field":"latestReleaseDate","url":"https://api.github.com/repos/scalameta/mdoc/releases/latest","checkedAt":"2026-10-23T00:00:00.000Z"},{"field":"firstRelease","url":"https://api.github.com/repos/scalameta/mdoc/releases?per_page=100","checkedAt":"2026-10-23T00:00:00.000Z"},{"field":"githubStargazers","url":"https://api.github.com/repos/scalameta/mdoc","checkedAt":"2026-10-23T00:00:00.000Z"},{"field":"contributors","url":"https://api.github.com/repos/scalameta/mdoc/contributors?per_page=1","checkedAt":"2026-10-23T00:00:00.000Z"},{"field":"runsAs","url":"https://scalameta.org/mdoc/docs/installation.html","checkedAt":"2026-10-23T00:00:00.000Z"},{"field":"language","url":"https://api.github.com/repos/scalameta/mdoc","checkedAt":"2026-10-23T00:00:00.000Z"}],"status":"active","ai":"authored"},"prose":"mdoc is a markdown documentation tool for Scala. It reads markdown sources, compiles and evaluates the Scala code blocks in them, and writes markdown in which each block shows its result, so the examples in the documentation are type-checked. It runs as the sbt-mdoc plugin in an sbt build, where the docs/mdoc task generates the documentation, from the command line through coursier, or as a library API. The project is maintained by the mdoc developers. A [migration guide](https://scalameta.org/mdoc/docs/tut.html) covers moving documentation over from tut.\n\n## Worth knowing\n\nmdoc writes markdown. Its DocusaurusPlugin builds a static site from that markdown with Docusaurus, which needs node and yarn. The JDK requirement differs between releases, as the README's compatibility table shows."}