@kong/markdown NPM

Kong Markdown

!IMPORTANT This repository and the @kong/markdown package are currently in development. Breaking changes should be expected.

Kong's open-source markdown renderer and live editor.

TODO

Utilize design tokens
Add new icons for toolbar
Possibly export a separate bundle as a web component utilizing petite-vue
Document theming instructions
Light / Dark mode
Default shikiji theme(s)
Supported languages (instead of allowing all)

Usage

Installation

Install the @kong/markdown package in your host project.

pnpm add @kong/markdown

# OR

yarn add @kong/markdown

Props

`v-model`

type: String
required: false
default: ''

Contributing & Local Development

To get started, install the package dependencies

pnpm install

Development Sandbox

This repository includes a Vue sandbox app (see the /sandbox directory) to allow you to experiment with icons.

Build and Preview the Development Sandbox

To build and run a local preview of the Sandbox:

pnpm run preview

Lint and fix

Lint package files, and optionally auto-fix detected issues.

# Stylelint only
pnpm run stylelint

# Stylelint and fix
pnpm run stylelint:fix

# ESLint only
pnpm run lint

# ESLint and fix
pnpm run lint:fix

Testing

Unit and component tests are run with Vitest.

# Run tests
pnpm run test

# Run tests in the Vitest UI
pnpm run test:open

Build for production

pnpm run build

Committing Changes

This repo uses Conventional Commits.

Commitizen and Commitlint are used to help build and enforce commit messages.

It is highly recommended to use the following command in order to create your commits:

pnpm run commit

This will trigger the Commitizen interactive prompt for building your commit message.

Enforcing Commit Format

Lefthook is used to manage Git Hooks within the repo.

A commit-msg hook is automatically setup that enforces commit message stands with commitlint, see lefthook.ymal
A pre-push hook is used that runs eslint before allowing you to push your changes to the repository

Additionally, CI will use commitlint to validate the commits associated with a PR in the Lint and Validate job.

Package Publishing

This repository utilizes Semantic Release for automated package publishing and version updates.

markdown markdown-it vue editor markdown editor markdown renderer

@everything-registry/sub-chunk-526 @kong-ui-public/documentation

1.7.16-pr.179.329cae0.0

12 months ago

1.7.27-pr.256.4d6d83a.0

9 months ago

1.7.14-pr.151.67e611c.0

1 year ago

1.7.30-pr.266.413166.0

8 months ago

1.7.23-pr.224.23a26ba.0

10 months ago

1.7.28-pr.261.7a53f07.0

9 months ago

1.7.16-pr.181.fb6e2a1.0

12 months ago

1.7.22-pr.212.cb20318.0

11 months ago

1.7.23-pr.235.cfc0f20.0

10 months ago

1.7.29-pr.268.255f1f3.0

8 months ago

1.7.28-pr.259.8238515.0

9 months ago

1.7.14-pr.154.ba3dbc7.0

1 year ago

1.7.23-pr.242.e519364.0

10 months ago

1.7.15-pr.161.fd8e16f.0

1 year ago

1.7.19-pr.197.2f02587.0

11 months ago

1.7.17-pr.186.798eb4f.0

12 months ago

1.7.22-pr.119.f482436.0

11 months ago

1.7.24-pr.250.9c9385d.0

10 months ago

1.7.14-pr.173.b406740.0

1 year ago

1.7.18-pr.189.58acb77.0

12 months ago

1.7.14-pr.176.c9adde4.0

1 year ago

1.7.14-pr.157.830dea6.0

1 year ago

1.7.27-pr.257.0a61147.0

9 months ago

1.7.23-pr.231.842b540.0

10 months ago

1.7.23-pr.226.afd5deb.0

10 months ago

1.7.18-pr.194.a255475.0

12 months ago

1.7.14-pr.162.cb7319b.0

1 year ago

1.7.19-pr.204.6790a61.0

11 months ago

1.7.23-pr.248.9cc1191.0

10 months ago

1.7.29-pr.268.1cc118e.0

8 months ago

1.7.18-pr.190.e397772.0

12 months ago

1.7.30-pr.264.d301852.0

8 months ago

1.7.17-pr.187.4787263.0

12 months ago

1.7.23-pr.214.d9d5213.0

11 months ago

1.7.23-pr.245.92617c3.0

10 months ago

1.7.22-pr.220.6f8bf0c.0

11 months ago

1.7.25-pr.249.0966c40.0

10 months ago

1.7.22-pr.127.4299258.0

11 months ago

1.7.26-pr.252.dd3b744.0

9 months ago

1.7.23-pr.228.4de3c96.0

10 months ago

1.7.28-pr.251.e64427e.0

9 months ago

1.7.18-pr.193.75428d2.0

12 months ago

1.7.14-pr.171.15a8211.0

1 year ago

1.7.14-pr.124.e00b3dc.0

1 year ago

1.7.14-pr.168.274a8ab.0

1 year ago

1.7.23-pr.232.8e59f54.0

10 months ago

1.7.16-pr.178.c620502.0

12 months ago

1.7.16-pr.184.2108791.0

12 months ago

1.7.23-pr.240.04be2c1.0

10 months ago

1.7.30

8 months ago

1.7.23-pr.239.2106e47.0

10 months ago

1.7.14-pr.165.9432ff1.0

1 year ago

1.7.20-pr.209.28e90f9.0

11 months ago

1.7.22-pr.211.bd8b85a.0

11 months ago

1.7.19-pr.200.a69d33f.0

11 months ago

1.7.26-pr.247.7a6d26b.0

9 months ago

1 year ago

1 year ago

12 months ago

12 months ago

12 months ago

11 months ago

1.7.28-pr.260.3dcaa6d.0

9 months ago

1.7.18-pr.191.c1dd4ae.0

12 months ago

11 months ago

11 months ago

11 months ago

10 months ago

10 months ago

10 months ago

9 months ago

1.7.19-pr.205.567f7e3.0

11 months ago

1.7.27

9 months ago

1.7.28

9 months ago

1.7.29

8 months ago

1.7.23-pr.237.db02e80.0

10 months ago

1.7.22-pr.221.19a86ab.0

11 months ago

1.7.16-pr.183.08cd70b.0

12 months ago

1.7.23-pr.241.98a19a3.0

10 months ago

1.7.19-pr.195.16592f6.0

11 months ago

1.7.23-pr.222.a9d900e.0

10 months ago

1.7.20-pr.203.321f30c.0

11 months ago

1.7.21-pr.210.86c56d9.0

11 months ago

1.7.15-pr.177.86f11a2.0

1 year ago

1.7.14-pr.169.68d340b.0

1 year ago

1.7.26-pr.254.f1baa67.0

9 months ago

1.7.14-pr.156.77a42f7.0

1 year ago

1.7.14-pr.153.57ad658.0

1 year ago

1.7.22-pr.219.c3ae0c5.0

11 months ago

1.7.22-pr.216.7e8562d.0

11 months ago

1.7.22-pr.172.f51f224.0

11 months ago

1.7.16-pr.185.2172e57.0

12 months ago

1.7.14-pr.175.3aef8fa.0

1 year ago

1.7.22-pr.215.5d982fe.0

11 months ago

1.7.19-pr.201.ebac5cb.0

11 months ago

1.7.23-pr.234.87f4935.0

10 months ago

1.7.14-pr.155.9140d48.0

1 year ago

1.7.14-pr.152.12e0ac6.0

1 year ago

1.7.28-pr.230.7c2dcb0.0

9 months ago

1.7.14-pr.158.0ecdb84.0

1 year ago

1.7.29-pr.265.b2fcbf2.0

8 months ago

1.7.19-pr.198.74da87c.0

11 months ago

1.7.24-pr.249.110209.0

10 months ago

1.7.16-pr.180.ccc02a8.0

12 months ago

1.7.22-pr.217.03bf3fb.0

11 months ago

1.7.12

1 year ago

1.7.13

1 year ago

1.7.12-pr.141.a115c7f.0

1 year ago

1.7.13-pr.113.0c7d5e3.0

1 year ago

1.7.12-pr.142.1dacaa6.0

1 year ago

1.7.13-pr.145.553d2ae.0

1 year ago

1.7.12-pr.143.88e57d4.0

1 year ago

1.7.11

1 year ago

1.7.11-pr.140.124291f.0

1 year ago

1.7.11-pr.139.08aff7a.0

1 year ago

1.7.10

1 year ago

1.7.9-pr.134.0fd6daa.0

1 year ago

1.7.9-pr.121.3067845.0

1 year ago

1.7.9

1 year ago

1.7.9-pr.128.d4a8a20.0

1 year ago

1.7.9-pr.138.bab3565.0

1 year ago

1.7.9-pr.133.05df81f.0

1 year ago

1.7.9-pr.125.2df11c5.0

1 year ago

1.7.10-pr.131.84d62bf.0

1 year ago

1.7.9-pr.135.5021336.0

1 year ago

1.7.9-pr.136.af8e248.0

1 year ago

1.6.1-pr.70.9bd0ce1.0

1 year ago

1.7.5-pr.81.1b0c762.0

1 year ago

1.6.2

1 year ago

1.7.4-pr.92.c6f9ff3.0

1 year ago

1.6.1

1 year ago

1.6.0

1 year ago

1.3.7-pr.37.4250d7e.0

1 year ago

1.6.2-pr.84.dbb4851.0

1 year ago

1.7.7-pr.105.9913434.0

1 year ago

1.6.3-pr.88.71b7e04.0

1 year ago

1.4.1-pr.77.f287918.0

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1.7.2-pr.89.014a78f.0

1 year ago

1.7.4

1 year ago

1.7.8-pr.118.bf4a863.0

1 year ago

1.7.2-pr.90.5370871.0

1 year ago

1.7.5-pr.32.e707932.0

1 year ago

1.5.0

1 year ago

1.7.7-pr.107.ce84131.0

1 year ago

1.7.7-pr.109.fbe7959.0

1 year ago

1.7.7-pr.104.a0bf7da.0

1 year ago

1.7.6-pr.96.070bc35.0

1 year ago

1.7.8-pr.116.ece8fc5.0

1 year ago

1.4.1-pr.78.197b1f1.0

1 year ago

1.3.7-pr.76.316f3f6.0

1 year ago

1.7.8-pr.112.3facf30.0

1 year ago

1.7.5-pr.75.9b8f2cf.0

1 year ago

1.7.7-pr.108.c852309.0

1 year ago

1.7.7-pr.106.2743c94.0

1 year ago

1.6.2-pr.83.604f344.0

1 year ago

1.7.8-pr.110.8f8773e.0

1 year ago

1.7.6-pr.101.694b8dc.0

1 year ago

1.4.2-pr.77.f287918.0

1 year ago

1.3.7-pr.66.c73acc5.0

1 year ago

1.7.8-pr.115.cdd656c.0

1 year ago

1.6.3-pr.88.51cb925.0

1 year ago

1.3.7-pr.71.be11c47.0

1 year ago

1.4.1

1 year ago

1.4.0

1 year ago

1.3.7-pr.73.b7af369.0

1 year ago

1.6.3-pr.88.082b038.0

1 year ago

1.7.7-pr.99.7bcac38.0

1 year ago

1.3.7-pr.50.e7602a9.0

1 year ago

1.7.8-pr.114.4117c1b.0

1 year ago

1.7.6-pr.103.a68029f.0

1 year ago

1.7.5-pr.94.8e6722c.0

1 year ago

1.5.1-pr.82.5dd0990.0

1 year ago

1.6.3-pr.88.0f8f7a4.0

1 year ago

1.7.8-pr.117.0bea2d8.0

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1.6.3-pr.87.dc28dbd.0

1 year ago

1.4.1-pr.79.445df0d.0

1 year ago

1.7.6-pr.100.4600c6a.0

1 year ago

1.5.1-pr.80.01de3b5.0

1 year ago

1.4.1-pr.77.c30595d.0

1 year ago

1.3.7-pr.71.5b4e88f.0

2 years ago

1.3.7-pr.71.c296b20.0

2 years ago

1.3.7-pr.71.2f8fcae.0

2 years ago

1.3.7-pr.71.95555cb.0

2 years ago

1.3.6-pr.69.9eb92c4.0

2 years ago

1.3.6-pr.65.9f3b123.0

2 years ago

1.3.6

2 years ago

1.3.6-pr.56.cda4c43.0

2 years ago

1.3.5

2 years ago

1.3.5-pr.64.1f8b881.0

2 years ago

1.3.4-pr.53.c6fdb9b.0

2 years ago

1.3.4-pr.55.ab4a5a1.0

2 years ago

1.3.4-pr.57.c6c0281.0

2 years ago

1.3.4-pr.58.dfe5f2c.0

2 years ago

1.3.4

2 years ago

1.3.3-pr.54.928d340.0

2 years ago

1.3.3

2 years ago

1.2.1-pr.44.835b478.0

2 years ago

1.3.2

2 years ago

1.3.1

2 years ago

1.3.0

2 years ago

1.2.1-pr.51.bf24df6.0

2 years ago

1.2.1-pr.46.9eff8be.0

2 years ago

1.2.1-pr.49.2c5f687.0

2 years ago

1.2.1-pr.45.4d21982.0

2 years ago

1.2.1-pr.42.b36349e.0

2 years ago

1.2.1-pr.51.a05ea89.0

2 years ago

1.2.1-pr.51.f665251.0

2 years ago

1.2.1-pr.48.f4089da.0

2 years ago

1.2.1-pr.48.10a5674.0

2 years ago

1.2.1-pr.48.4efce9f.0

2 years ago

1.2.0

2 years ago

1.1.1-pr.41.6040e92.0

2 years ago

1.0.5-pr.40.094004d.0

2 years ago

1.0.5-pr.34.f71ce9a.0

2 years ago

1.1.0

2 years ago

1.0.5-pr.36.a0f3648.0

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

1.0.0-pr.30.642a365.0

2 years ago

1.0.0-pr.28.47ec523.0

2 years ago

1.0.0-alpha.39

2 years ago

1.0.1-pr.31.bb81d9d.0

2 years ago

1.0.0-pr.29.1d4f15f.0

2 years ago

1.0.0-alpha.38

2 years ago

1.0.0-alpha.37

2 years ago

1.0.0-pr.25.fcd2bfa.0

2 years ago

1.0.0-pr.23.798eddc.0

2 years ago

1.0.0-pr.24.7342332.0

2 years ago

1.0.0-pr.20.9f8d861.0

2 years ago

1.0.0-pr.21.50bb34a.0

2 years ago

1.0.0-alpha.36

2 years ago

1.0.0-alpha.35

2 years ago

1.0.0-pr.22.b720ae8.0

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

1.0.0-pr.12.65cb7eb.0

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

1.0.0-pr.16.8ce2983.0

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

1.0.0-pr.11.fc562e0.0

2 years ago

1.0.0-alpha.18

2 years ago

1.0.0-alpha.17

2 years ago

1.0.0-pr.13.2baf7e9.0

2 years ago

1.0.0-pr.14.c486f91.0

2 years ago

1.0.0-pr.10.6a37828.0

2 years ago

1.0.0-pr.15.bf36932.0

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago