---
url: /reference/@cssdoc/core/functions/parseCssDocs.md
---
# Function: parseCssDocs()

```ts
function parseCssDocs(css, options?): CssDocEntry[];
```

Defined in: [packages/core/src/parse.ts:1043](https://github.com/thedannywahl/cssdoc/blob/main/packages/core/src/parse.ts#L1043)

Parse a CSS string into a documentation model. Records are delimited by `/**` doc comments carrying a
record tag (`@component`/`@name` by default; override via [ParseOptions.isRecordBoundary](../interfaces/CompileCustomMediaOptions.md#isrecordboundary));
everything from one boundary comment to the next belongs to that record.

## Parameters

### css

`string`

The CSS source (a generated stylesheet, with authored doc comments).

### options?

[`ParseOptions`](../interfaces/ParseOptions.md) = `{}`

[ParseOptions](../interfaces/ParseOptions.md).

## Returns

[`CssDocEntry`](../interfaces/CssDocEntry.md)\[]

One [CssDocEntry](../interfaces/CssDocEntry.md) per record, in document order.

## Example

```ts
import { parseCssDocs } from "@cssdoc/core";

const [badge] = parseCssDocs(badgeCssWithDocComments);
badge.modifiers.map((m) => m.name); // ["-color-danger", "-color-success", …]
```