{"id":23626373,"url":"https://github.com/yetanalytics/markdoc","last_synced_at":"2025-08-02T12:10:54.660Z","repository":{"id":45329437,"uuid":"439438593","full_name":"yetanalytics/markdoc","owner":"yetanalytics","description":"Tool that creates HTML files from Markdown files for documentation publishing","archived":false,"fork":false,"pushed_at":"2025-01-13T20:42:07.000Z","size":20,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-05-18T17:08:40.243Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Clojure","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yetanalytics.png","metadata":{"files":{"readme":"README.md","changelog":null,"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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-12-17T19:23:48.000Z","updated_at":"2025-01-13T20:42:09.000Z","dependencies_parsed_at":"2024-12-27T22:56:35.595Z","dependency_job_id":"fcdf2813-c317-40c0-8c42-e47c7cc591a0","html_url":"https://github.com/yetanalytics/markdoc","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/yetanalytics/markdoc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yetanalytics%2Fmarkdoc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yetanalytics%2Fmarkdoc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yetanalytics%2Fmarkdoc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yetanalytics%2Fmarkdoc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yetanalytics","download_url":"https://codeload.github.com/yetanalytics/markdoc/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yetanalytics%2Fmarkdoc/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268385921,"owners_count":24242105,"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","status":"online","status_checked_at":"2025-08-02T02:00:12.353Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2024-12-27T22:53:09.554Z","updated_at":"2025-08-02T12:10:54.634Z","avatar_url":"https://github.com/yetanalytics.png","language":"Clojure","readme":"# MarkDoc\n\nMarkDoc is a Markdown-\u003eHTML Documentation Converter in Clojure.\n\nThe purpose is to allow multiple formats of the exact same documentation to exist at build time. Markdown for ease-of-use in a repository, such as on GitHub, and HTML for publishing with distributions or hosting the documentation online.\n\n## Usage\n\nMarkDoc takes a directory of Markdown files (`:in-root`), a target directory for the HTML (`:out-root`) and (optionally) the location of a [Selmer](https://github.com/yogthos/Selmer) template (`:template-file`) with which to process the Markdown. Running MarkDoc looks like the following:\n\n```\nclj -X:convert :in-root '\"[dir of .md files]\"' \\\n:out-root '\"[HTML destination dir]\"' \\\n:template-file '\"[selmer template file]\"'\n```\n\n## Templates\n\nSee [Selmer](https://github.com/yogthos/Selmer) for full template usage documentation. By default MarkDoc provides two variables to the template at runtime:\n\n`{{content}}` - The rendered HTML from a given MD file.\n\n`{{sha}}` - If MarkDoc is run from within a Git repository for the project it's being used on this will contain the current Git SHA. Potentially useful for tracking doc versions. Otherwise this tag will hold the default value \"No SHA found.\"\n\nYou can also add your own variables for the template by using the optional argument `:template-vars` and passing in a k/v map of the arguments in [EDN](https://github.com/edn-format/edn) syntax. The example below passes in the `version` variable which can be printed in the template using `{{version}}`:\n\n```\nclj -X:convert :in-root '\"doc/\"' \\\n:out-root '\"html/\"' \\\n:template-file '\"templates/docs.html.template\"' \\\n:template-vars '{:version \"v0.0.2\"}'\n```\n\nTake care NOT to use the key `:content`\n\n## License\n\nCopyright © 2021-2025 Yet Analytics, Inc.\n\nDistributed under the Apache License version 2.0.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyetanalytics%2Fmarkdoc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyetanalytics%2Fmarkdoc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyetanalytics%2Fmarkdoc/lists"}