{"id":27621767,"url":"https://github.com/TimoKats/mdrss","last_synced_at":"2025-04-23T08:02:27.550Z","repository":{"id":247229487,"uuid":"825307330","full_name":"TimoKats/mdrss","owner":"TimoKats","description":"Convert markdown files to RSS feed using GO.","archived":false,"fork":false,"pushed_at":"2025-04-21T05:07:06.000Z","size":85,"stargazers_count":115,"open_issues_count":0,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-21T06:28:26.946Z","etag":null,"topics":["go","markdown","rss"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TimoKats.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"ko_fi":"timokats"}},"created_at":"2024-07-07T12:17:21.000Z","updated_at":"2025-04-21T05:07:10.000Z","dependencies_parsed_at":"2024-08-13T21:16:39.822Z","dependency_job_id":"35263e4d-d045-41a2-b932-7766bdb1f9bb","html_url":"https://github.com/TimoKats/mdrss","commit_stats":null,"previous_names":["timokats/mdrss"],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TimoKats%2Fmdrss","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TimoKats%2Fmdrss/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TimoKats%2Fmdrss/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TimoKats%2Fmdrss/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TimoKats","download_url":"https://codeload.github.com/TimoKats/mdrss/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250395265,"owners_count":21423397,"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":["go","markdown","rss"],"created_at":"2025-04-23T08:02:26.624Z","updated_at":"2025-04-23T08:02:27.543Z","avatar_url":"https://github.com/TimoKats.png","language":"Go","funding_links":["https://ko-fi.com/timokats"],"categories":["Go"],"sub_categories":[],"readme":"# 📝MDRSS\n[![Go Report](https://goreportcard.com/badge/github.com/TimoKats/mdrss)](https://goreportcard.com/badge/github.com/TimoKats/mdrss)\n[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n[![GitHub tag](https://img.shields.io/github/tag/TimoKats/mdrss?include_prereleases=\u0026sort=semver\u0026color=blue)](https://github.com/TimoKats/mdrss/releases/)\n\n\nMDRSS is a markdown to RSS converter written in GO. With this tool, you can write articles in a local folder and have them automatically formatted to an RSS compliamdrss XML file. Moreover, MDRSS automatically takes care of publication dates, categories, formatting, etc.\n\n## Getting started\nYou can install the binary using `go install github.com/TimoKats/mdrss@latest`. After this you can add your configuration in `~/.mdrss` or you can specify your own config path like so: `mdrss --config other/path/to/config update`.\n\n```ini\nAuthor=Timo\nDescription=Timo weblog\nInputFolder=/path/to/articles/ ; This will comdrssain your markdown files\nOutputFile=/path/to/webserver/index.xml\nLink=index.xml ; can be anything, might be deprecated\n```\n\n## Publication\nIn your input folder, you can add an article by creating a .md file. Note, if your filename is prefixed with `draft-` it will not be included in the RSS file.  \n\nFinally, you can type `mdrss ls` to view the articles ready for publishing and `mdrss update` to create the RSS feed. Note, the title of the RSS articles are based on markdown headers. E.g. format the first line of the markdown articles as so: `# this is a title`.\n\n\n## Docs\n\nNote, topics are added based on subfolders in your input folder. For example, if your input folder is `articles/`, then `articles/tech` will contain the markdown files for tech related articles.\n\n\u003ctable\u003e\n  \u003cthead\u003e\n    \u003ctr\u003e\n      \u003cth width=\"500px\"\u003eField\u003c/th\u003e\n      \u003cth width=\"500px\"\u003eDescription\u003c/th\u003e\n    \u003c/tr\u003e\n  \u003c/thead\u003e\n  \u003ctbody\u003e\n    \u003ctr width=\"600px\"\u003e\n      \u003ctd\u003eAuthor\u003c/td\u003e\n      \u003ctd\u003eName of the RSS feed author.\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr width=\"600px\"\u003e\n      \u003ctd\u003eDescription\u003c/td\u003e\n      \u003ctd\u003eDescription of the RSS feed.\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr width=\"600px\"\u003e\n      \u003ctd\u003eInputFolder\u003c/td\u003e\n      \u003ctd\u003eFolder containing the markdown files. Add subfolders to enable the usage of topics.\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr width=\"600px\"\u003e\n      \u003ctd\u003eOutputFile\u003c/td\u003e\n      \u003ctd\u003eSet this to write all articles to *one* XML file.\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr width=\"600px\"\u003e\n      \u003ctd\u003eOutputFolder\u003c/td\u003e\n      \u003ctd\u003eSet this to write RSS topics to seperate XML files in one folder. File names will be based on topics. \u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr width=\"600px\"\u003e\n      \u003ctd\u003eLink\u003c/td\u003e\n      \u003ctd\u003eA bit redundant, but you can set this to the page hosting the RSS feed. \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/tbody\u003e\n\u003c/table\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTimoKats%2Fmdrss","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FTimoKats%2Fmdrss","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTimoKats%2Fmdrss/lists"}