{"id":15130822,"url":"https://github.com/jrdnbradford/readmdtable","last_synced_at":"2025-10-23T07:30:43.594Z","repository":{"id":255554401,"uuid":"852362747","full_name":"jrdnbradford/readMDTable","owner":"jrdnbradford","description":"R 📦 for reading markdown tables into tibbles","archived":false,"fork":false,"pushed_at":"2025-02-03T19:42:30.000Z","size":7631,"stargazers_count":6,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-03T20:31:14.606Z","etag":null,"topics":["data","data-analysis","data-analytics","data-extraction","data-mining","data-science","markdown","markdown-parser","markdown-table","r","r-package","r-programming"],"latest_commit_sha":null,"homepage":"https://jrdnbradford.github.io/readMDTable/","language":"R","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/jrdnbradford.png","metadata":{"files":{"readme":"README.Rmd","changelog":"NEWS.md","contributing":null,"funding":null,"license":"LICENSE.md","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":"2024-09-04T17:16:54.000Z","updated_at":"2025-01-26T00:07:32.000Z","dependencies_parsed_at":"2025-01-25T17:26:02.253Z","dependency_job_id":"780d2641-7efe-47c9-ad5e-fec370a9eb72","html_url":"https://github.com/jrdnbradford/readMDTable","commit_stats":{"total_commits":74,"total_committers":1,"mean_commits":74.0,"dds":0.0,"last_synced_commit":"352ab1c086560134e89434e7813e8cbdee5327af"},"previous_names":["jrdnbradford/readmdtable"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jrdnbradford%2FreadMDTable","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jrdnbradford%2FreadMDTable/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jrdnbradford%2FreadMDTable/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jrdnbradford%2FreadMDTable/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jrdnbradford","download_url":"https://codeload.github.com/jrdnbradford/readMDTable/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237793911,"owners_count":19367421,"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":["data","data-analysis","data-analytics","data-extraction","data-mining","data-science","markdown","markdown-parser","markdown-table","r","r-package","r-programming"],"created_at":"2024-09-26T03:06:52.844Z","updated_at":"2025-10-23T07:30:43.199Z","avatar_url":"https://github.com/jrdnbradford.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\noutput: github_document\n---\n\n```{r options, echo = FALSE}\nknitr::opts_chunk$set(\n  collapse = TRUE,\n  comment = \"#\u003e\",\n  fig.path = \"README-\"\n)\n```\n\n# readMDTable \u003ca href=\"https://jrdnbradford.github.io/readMDTable/\"\u003e\u003cimg src=\"man/figures/logo.png\" align=\"right\" height=\"139\" alt=\"readMDTable website\" /\u003e\u003c/a\u003e\n\n\u003c!-- badges: start --\u003e\n[![R-CMD-check](https://github.com/jrdnbradford/readMDTable/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/jrdnbradford/readMDTable/actions/workflows/R-CMD-check.yaml)\n[![CRAN Checks](https://badges.cranchecks.info/summary/readMDTable.svg?label=CRAN%20Status)](https://cran.r-project.org/web/checks/check_results_readMDTable.html)\n[![CRAN version](https://img.shields.io/cran/v/readMDTable?logo=R\u0026label=CRAN%20Version)](https://CRAN.R-project.org/package=readMDTable)\n[![Dev version](https://img.shields.io/github/r-package/v/jrdnbradford/readMDTable/main?label=Dev%20Version\u0026logo=github\u0026labelColor=3e474f\u0026logoColor=959da5)](https://github.com/jrdnbradford/readMDTable)\n[![GitHub License](https://img.shields.io/github/license/jrdnbradford/readMDTable?logo=GNU\u0026label=License)](https://www.gnu.org/licenses/gpl-3.0)\n[![Codecov test coverage](https://codecov.io/gh/jrdnbradford/readMDTable/graph/badge.svg)](https://app.codecov.io/gh/jrdnbradford/readMDTable)\n[![Monthly Downloads](https://cranlogs.r-pkg.org/badges/readMDTable?color=ff69b4)](https://CRAN.R-project.org/package=readMDTable)\n[![Total Downloads](https://cranlogs.r-pkg.org/badges/grand-total/readMDTable?color=ff69b4)](https://CRAN.R-project.org/package=readMDTable)\n\u003c!-- badges: end --\u003e\n\nreadMDTable helps convert raw markdown tables from a string, file, or URL to tibbles.\n\nMany sites (like GitHub) convert markdown tables into HTML tables, making both available. See the vignette [Benchmarking Against rvest](https://jrdnbradford.github.io/readMDTable/articles/rvest-benchmarks.html) to help determine if you should use readMDTable or [rvest](https://rvest.tidyverse.org/) in those circumstances.\n\n## Installation\n\nInstall the latest [CRAN](https://CRAN.R-project.org/package=readMDTable) release with:\n```{r cran-install, eval=FALSE}\ninstall.packages(\"readMDTable\")\n```\n\nInstall the development version from [GitHub](https://github.com/jrdnbradford/readMDTable) using [pak](https://github.com/r-lib/pak):\n```{r pak-install, eval=FALSE}\n# install.packages(\"pak\")\npak::pkg_install(\"jrdnbradford/readMDTable\")\n```\n\n## Usage\n```{r install, echo=FALSE, include=FALSE}\nlibrary(readMDTable)\n```\nIf you have a string, file, or URL whose entire content is just a markdown *table*, you should use `read_md_table` which will return a tibble.\n\nIf the string, file, or URL is a markdown *file* that has *other content* besides just a table or tables, such as headings, paragraphs, etc, you should use `extract_md_tables` which will parse the file and return a tibble or list of tibbles.\n\n### From a File\nRead in an example markdown table from the package:\n```{r example-1}\nmtcars_file \u003c- read_md_table_example(\"mtcars.md\")\n\nread_md_table(mtcars_file)\n```\n\nRead in an example markdown file that has multiple tables as well as headings and paragraphs:\n```{r example-2}\nmtcars_file \u003c- read_md_table_example(\"mtcars-split.md\")\n\nextract_md_tables(mtcars_file, show_col_types = FALSE)\n```\n\n### From a String\n```{r example-3}\nread_md_table(\"| len | supp | dose |\\n|---|---|---|\\n| 4.2 | VC | 0.5 |\\n\")\n```\n\n### From a URL\n```{r example-4}\nread_md_table(\"https://raw.githubusercontent.com/jrdnbradford/readMDTable/main/inst/extdata/iris.md\")\n```\n```{r example-5}\nextract_md_tables(\"https://raw.githubusercontent.com/jrdnbradford/readMDTable/main/inst/extdata/ToothGrowth.md\")\n```\n\n### Warnings and Messy Data\n`read_md_table` will throw warnings by default if there are potential issues with the markdown table. In many cases it will still correctly read in the messy data if you use `force = TRUE`:\n```{r example-6}\nread_md_table(\n\"  | Name   | Age |            City        | Date   |\n|-------|-----|-------------|------------|\n  | Alice |      30 |           | 2021/01/08 |\n  | Bob          | 25  | Los Angeles | 2023/07/22\n  | Carol | 27       | Chicago     |      |\",\n  force = TRUE\n)\n```\n\n`extract_md_tables` will fail to recognize markdown tables that do not fit the markdown table format.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjrdnbradford%2Freadmdtable","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjrdnbradford%2Freadmdtable","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjrdnbradford%2Freadmdtable/lists"}