# Goldmark v1 to v2 Migration

Migrates a Go application from goldmark v1 to the v2 API.

- Repository: https://github.com/yuin/goldmark (5086 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add yuin/goldmark --skill migrate-goldmark-app-v1-to-v2 -g -a claude-code -y`
Codex: `npx skills add yuin/goldmark --skill migrate-goldmark-app-v1-to-v2 -g -a codex -y`
Cursor: `npx skills add yuin/goldmark --skill migrate-goldmark-app-v1-to-v2 -g -a cursor -y`
Gemini CLI: `npx skills add yuin/goldmark --skill migrate-goldmark-app-v1-to-v2 -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add yuin/goldmark`

## Description

Migrate your application from goldmark v1 to v2.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# migrate-goldmark-app-v1-to-v2
## Description
This skill helps you migrate a goldmark (https://github.com/yuin/goldmark) extension from version 1 to version 2. It
provides guidance on the changes needed to update your project to be compatible with the new version of goldmark.

## Knowledges

- [CommonMark key points](../../references/commonmark-key-points.md) : List of key points of CommonMark spec that you should be aware of when implementing a goldmark extension.
- [Breaking changes in v2](../../references/breaking-changes-in-v2.md) : List of breaking changes in goldmark v2 that you should be aware of when migrating your extension from v1 to v2.

## Migration steps
### Overview of the migration process

- Create a migration plan for the application.
- **MUST** ask human to confirm that the migration plan is acceptable before proceeding with the migration.
- **MUST** ask human to how to test the application after migration before proceeding with the migration.
  - e.g. : "How do you want to test the application after migration? Do you have any test cases or examples that you want to use for testing?"
- Execute the migration plan to update the application code to be compatible with goldmark v2.
- Update the test cases to ensure that the application works as expected with goldmark v2.
- Test the application with goldmark v2 to ensure that it works as expected. If there are any issues, fix them and re-test until the application works as expected.
- Update the documentation to reflect any changes made during the migration process.

### Create a migration plan
#### Task

- Make sure you have read and understood the [Breaking changes in v2](../../references/breaking-changes-in-v2.md) document.
- Make sure you have read and understood the [How to create an extension](./references/how-to-create-an-extension.md) document.
- You create a ./features/goldmark-migration-plan.md file that contains a migration plan for the extension. 

#### Extension

The rest: https://github.com/yuin/goldmark/blob/HEAD/.agent-plugins/migrate-goldmark-v1-to-v2/skills/migrate-goldmark-app-v1-to-v2/SKILL.md