{"id":18817599,"url":"https://github.com/skatkov/yard-markdown","last_synced_at":"2025-04-13T23:24:57.286Z","repository":{"id":204564201,"uuid":"712150457","full_name":"skatkov/yard-markdown","owner":"skatkov","description":"yard plugin to generate markdown documentation","archived":false,"fork":false,"pushed_at":"2024-12-28T23:40:11.000Z","size":3043,"stargazers_count":12,"open_issues_count":5,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-27T13:41:35.670Z","etag":null,"topics":["markdown","yard"],"latest_commit_sha":null,"homepage":"https://poshtui.com","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/skatkov.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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}},"created_at":"2023-10-30T22:29:53.000Z","updated_at":"2024-12-28T23:40:13.000Z","dependencies_parsed_at":null,"dependency_job_id":"f89821ed-5fde-484e-981c-049ea81ea068","html_url":"https://github.com/skatkov/yard-markdown","commit_stats":null,"previous_names":["skatkov/yard-markdown"],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skatkov%2Fyard-markdown","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skatkov%2Fyard-markdown/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skatkov%2Fyard-markdown/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skatkov%2Fyard-markdown/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/skatkov","download_url":"https://codeload.github.com/skatkov/yard-markdown/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248795302,"owners_count":21162746,"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":["markdown","yard"],"created_at":"2024-11-08T00:12:13.060Z","updated_at":"2025-04-13T23:24:57.275Z","avatar_url":"https://github.com/skatkov.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Yard::Markdown\n\nYard plugin to output markdown documentation.\n\n## Motivation\nMarkdown has become the de-facto documentation standard. I heavily rely on Obsidian to render my storage of markdown notes. But markdown is used not just for scribbles, supported is far and wide. We can render markdown file on any device, probably even on thermometer with a screen. But also everyone knows enough markdown to be dangerous (or productive).\nIt's a pitty that rdoc and yard can't output a proper markdown file. I would like to change that.\n\n## Goals:\n- Compatible with Github Flavored Markdown\n- Produce .csv index file\n- Mimick yard html layout where it makes sense to maintain familiarity\n\n## Usage\nYard doesn't load plugin by default, so you need to load plugin through `~/.yard/config`:\n\n```yaml\n!!!yaml\nload_plugins: true\nautoload_plugins:\n  - markdown\n```\n\nInstall a plugin\n```\ngem install yard-markdown\n```\n\nRun `yardoc --format=markdown` to generate markdown documentation.\n\n## Note on RDoc support\nIt seems important to note, that yard claims to have support for RDoc. That support is certainly present, but output for rdoc is dramatically different. A lot of useful information seems lost in the process.\n\nIf you know how to improve that, please get in touch or submit a patch.\n\nSo in meantime, there is work going on a competing gem for RDoc and it's called [rdoc-mardown gem](https://github.com/skatkov/rdoc-markdown/).\n\n## Note on index.csv file\nThis gem emits index of all markdown files in a index.csv file.\n\nThere are decent tools that offer search through structured plain-text files. But my expectation is that nobody will use CSV as an actual search index, but rather import it into something that performs this function better.\n\nIn my personal use-case, I use SQLite. All other databases seem to have a good support for CSV imports.\n\n## Testing\nUnit tests can't really test this gem properly. So it's semi-manual process of making changes and reviewing output.\n\nEasiest way to test is to run `rake generate_example` and check output in `example` directory.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskatkov%2Fyard-markdown","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fskatkov%2Fyard-markdown","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskatkov%2Fyard-markdown/lists"}