Skip to content

parsermd

0.2.0Package record

Formal Parser and Related Tools for R Markdown Documents

0packages dependsuggested by 2
16.9Kdownloads / year
73.0%test coverage
13/13flavors OK

Overview

About

An implementation of a formal grammar and parser for R Markdown documents using the Boost Spirit X3 library. It also includes a collection of high level functions for working with the resulting abstract syntax tree.

Changes in 0.2.0
  • **Breaking Change**: Migrated from S3/S4 classes to S7 classes for all AST node types (rmd_ast, rmd_chunk, rmd_heading, etc.)
  • **Breaking Change**: Removed deprecated rmd_subset() and related helper functions (rmd_get_node(), rmd_get_chunk(), rmd_get_markdown(), rmd_has_node(), rmd_has_chunk(), rmd_has_markdown()). Use rmd_select() with tidyselect syntax instead.
  • Added support for yaml chunk options - e.g. (#| echo: false)
  • Added support for fenced divs - e.g. (::: {.class} ... :::)
  • Added support for markdown code blocks
  • Added support for yaml expressions - e.g. (!expr)
  • Added support for parsing collections of Rmd and qmd files - see parse_qmd_collection() and parse_rmd_collection()
  • Removed option to not parse yaml - this is now always parsed. Based on this yaml node classes were simplified to just include rmd_yaml.
  • Added support for Pandoc-style ordered fenced attributes for code blocks, fenced divs, and spans
  • Added rmd_fenced_div_wrap() function to wrap selected nodes with fenced divs
  • Added rmd_insert() function to insert nodes relative to selected nodes
  • Added support for code block literals - e.g. ```{{r}}
Show all changes in 0.2.0Hide the rest of the changes in 0.2.0
  • Added support for 2ndary parsing to handle inline elements:
  • quarto shortcodes, inline code, and spans
  • Enhanced rmd_select() functionality and node manipulation
  • Added has_heading() helper function for selecting heading nodes using glob patterns
  • Added by_fenced_div() helper function for selecting fenced div sections using attribute patterns
  • Added keep_yaml argument to rmd_select() (defaults to TRUE) to automatically include YAML nodes in selections

From NEWS.md in the release

Install

Health

CRAN checks
13OK
Slowest check: 6.4 min · r-oldrel-windows-x86_64
Status changes
  • OK13 OK2026-08-05
  • NOTE12 OK, 1 NOTE2026-08-01
  • OK13 OK2026-05-02
  • NOTE12 OK, 2 NOTE2026-04-22
  • ERROR11 OK, 2 NOTE, 1 ERROR2026-04-18
Show 1 earlier changeHide 1 earlier change
  • NOTE12 OK, 2 NOTE2026-03-10
Advisories

none known

Documentation

In release 0.2.0
READMEYes · 145 wordsVignettesYes · 5 · dynamicNEWSYes · 100% structured · mentions 0.2.0Citation fileNoWebsiteYes · pkgdown
Help pages
34 (2 internal)includes a package overview page
Examples that run
100%13 run in a plain check
Exported functions with examples
39%
Documented parameters
100%
Return-value docs
61%
Help pages citing references
0%

Downloads

16.9K
CRAN downloads in the past year
Rank #2,940 · ~46/day · ~1.4K/mo
Daily download trend is not available in this view yet.
1.8K30 days
4.7K90 days
16.9K1 year
Compare downloads with other packages →
Also on367 r2u4 autocran

Repository

92Stars
6Forks
3Open issues
0Open PRs
3Releases
560Commits
5Commit identities
560 commits · Last activity 2026-02-27 · 0% stars, 30d · Default branch at 0.2.0.9000, ahead of CRAN 0.2.0 (checked 2026-10-18)
Responsiveness
How these are sampled
PRs merged (all time)
80%
Median days to close, 50 most recently updated closed issues
220
Median days to close, 50 most recently updated closed PRs
0

Stars over time

2025-09-16 · 892026-07-07 · 92
PracticesBeta

9 development-tooling and community-health practices detected across 4 families in the upstream repository

Checks run against github.com/rundel/parsermd on 2026-10-18.

Continuous integration (2)
GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel

Docs source (4)
README.qmdpkgdown

GitHub Pages site last deployed 2025-08-19 · The repository has a site deploy workflow

pkgdown site last built 2025-08-19

CRAN release process (1)
cran-comments.md
Lint, format, editor (2)
VS CodeRStudio project
How this is detected·Detection ruleset v3 (2026-09-26)
AI coding toolsBeta

This repository shows signs of AI coding tools.

  • Claude Codefirst seen 2025-06-06
    Named in .Rbuildignore: .claude, CLAUDE.md
    Named in .gitignore: .claude, CLAUDE.md
  • Julesfirst seen 2025-08-17
    Commits: 1 by its own account
Counts are commits, not lines of code. Commits by a tool's accounts count once across all of its accounts. Commits crediting it are the largest count among its credit lines, a minimum.How this is detected·Detection ruleset v4 (updated 2026-09-27)

Dependencies

Declared dependencies
24 external dependencies (excludes base and recommended)

Installing parsermd adds 61 packages (36 with compiled code, 53 MB of source tarballs). Heaviest: BH 14 MB, stringi 11 MB, bslib 5.6 MB.

Depends (1)
R >= 4.1.0
LinkingTo (2)
Enhances (0)
none
Reverse dependencies
0direct
0indirect
Suggested by 2
Suggests, most downloaded first

People & History

People (1)
Author, Maintainer since 0.1.0 (2021)
Releases (5)

Pick two releases to compare their code metrics.

  • R
    R 4.6.0 released · 2026-04-24
  • 0.2.0Latest
    record
    2025-08-19 · current release · diff ↗ ·
    removed 7 exports
    rmd_get_chunk, rmd_get_markdown, rmd_get_node, rmd_has_chunk, rmd_has_markdown, rmd_has_node, rmd_subset
    added 40 exports
    rmd_node_attr<-, rmd_node_content<-, rmd_node_label<-, rmd_node_options<-, by_fenced_div, has_code, has_heading, has_inline_code, has_shortcode, parse_qmd, parse_qmd_collection, parse_rmd_collection, rmd_ast, rmd_ast_append, rmd_ast_prepend, rmd_chunk, rmd_code_block, rmd_code_block_literal, rmd_extract_inline_code, rmd_extract_shortcodes, rmd_extract_spans, rmd_fenced_div_close, rmd_fenced_div_open, rmd_fenced_div_wrap, rmd_has_inline_code, rmd_has_shortcode, rmd_has_span, rmd_heading, rmd_inline_code, rmd_insert and 10 more
  • R
    R 4.5.0 released · 2025-04-11
  • R
    R 4.4.0 released · 2024-04-24
  • 0.1.3
    record
    2024-01-16 · diff ↗
  • R
    R 4.3.0 released · 2023-04-21
  • R
    R 4.2.0 released · 2022-04-22
  • 0.1.2
    record
    2021-05-20 · diff ↗
  • 0.1.1
    record
    2021-05-19 · diff ↗
  • R
    R 4.1.0 released · 2021-05-18
  • 0.1.0
    record
    2021-05-10
  • R
    R 4.0.0 released · 2020-04-24

Package metadata

First published
2021-05-10
Total releases
5 / 5 yrs
License
MIT + file LICENSE OSI
Minimum R
≥ 4.1.0
Download size
433 KB

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("parsermd")
Rundel, C. (2025). parsermd: Formal Parser and Related Tools for R Markdown Documents (Version 0.2.0) [Computer software]. https://doi.org/10.32614/CRAN.package.parsermd

This package has no citation file, so citation() returns this entry built from DESCRIPTION.

Cite the R Observatory

For a number measured here: a download total, a coverage figure, an archival date.

APA

Balamuta, J. J. (2026). R Observatory: Metrics for parsermd version 0.2.0 [Data set]. HJJB, LLC. Data release v2026-10-20. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-20, which the citation names so these numbers can be found later. More on citing and the projects behind them.

Report a problem with this page →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy