1.0.0-alpha.60 (2023-03-15)

Features

support multiple selectors for scrollOffset (86e2a6f)
theme: add animation to mobile page outline dropdown (a6b18a8)

1.0.0-alpha.59 (2023-03-15)

Bug Fixes

handle async enhanceApp when extending themes (52b04f3)
theme: improve Chinese font handling (81ae1c7), closes #2036
theme: move doc-footer-before slot into the footer (b0160bc), closes #2082

Features

defineClientComponent helper (2ad668c)

1.0.0-alpha.58 (2023-03-14)

Bug Fixes

fix optional component imports from default theme (7b0f289)

1.0.0-alpha.57 (2023-03-14)

Bug Fixes

types: allow void return in transformHead hook (32dfaf5)

Features

expose page and assets on build hooks TransformContext (468c049)
theme: a11y improvements (3b6a6d1)
theme: aria-label for social links (6ca34c4)
theme: page outline for mobile (7182c42)
theme: support extending default theme without importing fonts (da1691d)
theme: use more accessible header anchors #2040

Performance Improvements

theme: preload font (24735db)

BREAKING CHANGES

markdown.headers is now disabled by default. This means PageData will no longer include extracted headers by default unless this option is explicitly enabled. This is because the default theme now extracts page headers at runtime, so the data is no longer needed by default.

1.0.0-alpha.56 (2023-03-13)

Bug Fixes

do not include head tags in inlined site data (2f26693)

1.0.0-alpha.55 (2023-03-13)

Bug Fixes

fix scroll to hash on new tab during dev (9aafc88), closes #653
gracefully handle config update with syntax error (470ce3d), closes #2041

Performance Improvements

inline site data on page (22ace7b)
kickoff main chunk fetch earlier in browsers without modulepreload support (d64a76e)

1.0.0-alpha.54 (2023-03-13)

Bug Fixes

fix chunking logic that causes breakage (bed202d), closes #2072 #2073 #2074 #2075

1.0.0-alpha.53 (2023-03-13)

Bug Fixes

avoid circular dependency between siteData virtual module and useData() (905f58b), closes #2072 #2073 #2074

Features

createContentLoader (d2838e3)
theme: editLink can accept function (#2058) (192708d)

1.0.0-alpha.52 (2023-03-11)

Bug Fixes

fix line higlighting for empty lines (9708510)
fix rewrites with non ascii chars (6ce88da), closes #2017
fix same page hash links with encoded chars (e05a3f2), closes #1749
properly serialize header in outline (8ab36d0)
remove @vue/devtools from force include (9bd940f)
respect user vue alias (63f33d2), closes #1065
theme: re-support dynamic headers (657a7d3)
trim spaces from outline headers (9ceff1d)

Features

allow disabling markdown.headers (868a9ff)

Performance Improvements

improve default theme chunking (f6cb4c0)

BREAKING CHANGES

default theme config option outlineBadge has been removed. Badges in headers are now always excluded when generating outline text.

1.0.0-alpha.51 (2023-03-09)

Bug Fixes

theme: align number to code line (#2044) (27e3adf)
theme: remove log in VPContent (747a04d)

Features

theme: add not-found layout slot (#2054) (41987b6)

Performance Improvements

a11y: add aria-label to language button (#2025) (322c633)

1.0.0-alpha.50 (2023-03-07)

Bug Fixes

avoid deprecation warning when using --force (0c0b6cc)
ensure HMR works properly for page outline (1457681), closes #1281
extract all headers by default (580a8e1)
respect command line minify and outDir options (22047f3)
theme: make tip box text color darker (3158115)
theme: prevent text wrapping in nav dropdown menu (2a1abbe)

Features

data-loader: defineLoader() type helper (4673bb1)
data-loader: pass watched files into load() (e29b6a0)
deprecate Theme.setup (868a586)
export loadEnv from vite (7609704)
expose isNotFound on PageData, deperecate Theme.NotFound (74caccd)
expose params at top level in useData() (66f94fd)
support $params in page components (a4ac055)
support Theme.extends (f39b6a9)
theme: add as prop to Content (#2011) (254e15b)
theme: add home-hero-info slot (#1807) (996a5f4)
vitepress init command (#2020) (38bbdad), closes #1252

1.0.0-alpha.49 (2023-02-28)

Bug Fixes

disable fuzzy link recognition by default (2450710)
dyamic routes w/ srcDir + relative imports (b075ee5)
hmr on deps change of data loaders (5913ebc)
normalize all paths in config (8e8fcd9)
theme: "copy code" button not readable on hover state (#819) (#1892) (#1998) (c2de4ca)
theme: tip custom container has wrong bg color for <code> block (d9a2e6e)
update route configs on file add / delete (bccce98)

Features

dynamic routes (24fa862)
theme: enhance readability of custom containers (#1824) (#1989) (472b6ec)

1.0.0-alpha.48 (2023-02-26)

Bug Fixes

compat: remove use of array.at (fd99590)
theme: add height constraints to hero image (#1983) (803d5b6)
theme: allow empty details in home feature (#1936) (#1963) (b56351c)
theme: show external link icon in navbar (#1881) (8e6e8d9), closes #1948
theme: show external link icon on same line (#1880) (6218b10)

Features

build: add support for custom languages (#1837) (5a6d384)
theme: make prev/next links changeable (#1972) (b8a5e8e)
theme: support custom target and rel in navbar links (#1993) (e2d4edf)

1.0.0-alpha.47 (2023-02-20)

Bug Fixes

build: show error stack in logs (#1960) (c4d8d72)
custom titles of code snippets inside code groups (#1834) (bcb8cbf)
types: augment vite user config (#1946) (5c9b75e)

Reverts

"docs: add linkage for code-groups in getting-started" (#1943) (ed90724), closes #1906

1.0.0-alpha.46 (2023-02-12)

Bug Fixes

build: prepend base to all internal non-relative links (#1908) (dcf2941)
theme-default: avoid preconnect without algolia (#1902) (616fe5b)
theme-default: remove duplicate judgments in preconnect() (#1903) (48c9b11)
theme: make features support line wrapping (#1913) (ea43076)

Features

build: use vite logger (#1899) (a00bb62)
shiki: support ansi code highlight (#1878) (f974381)
theme: support disabling aside globally (#1925) (dd0c4c6)

BREAKING CHANGES

build: base is now prepended to all internal (non-relative) links, including any reference to a file present in the public directory. If you want the earlier behavior for such links, use absolute links.

1.0.0-alpha.45 (2023-01-31)

Bug Fixes

safari use window.requestIdleCallback (#1871) (507b193)

1.0.0-alpha.44 (2023-01-31)

Bug Fixes

take <a> in SVG into account (#1850) (010b3e5)
theme: infer collapsible from collapsed (#1865) (dea6cfa)

Features

theme: preconnect algolia when idle (#1851) (1f77577)

BREAKING CHANGES

theme: collapsible is dropped from sidebar, use collapsed instead

1.0.0-alpha.43 (2023-01-29)

Bug Fixes

build: hmr with rewrites when base is set (a05956f)

1.0.0-alpha.42 (2023-01-29)

Bug Fixes

build: consider base when checking actual pathname (#1858) (cf8ad1a)

1.0.0-alpha.41 (2023-01-28)

Bug Fixes

check document instead of window to detect browser (#1833) (0f145cb)
router: avoid duplicate history entries (#1827) (1553dbc)
theme: don't show border on navbar when sidebar is there (#1845) (3db532e)

Features

build: allow ignoring only localhost dead links (#1821) (fe52fa3)
build: expose vitepress site config to vite plugins (#1822) (05430e4)
build: support rewrites (#1798) (00abac6)
stable cleanUrls (#1852) (5ae4fbd)
theme: allow removing badge text from outline (#1825) (5d2fc3f)
theme: enable multi level sidebar nesting (#1360) (#1835) (c35a1f0), closes #1361 #1680

1.0.0-alpha.40 (2023-01-20)

Bug Fixes

theme: nav bg not being applied on some viewport (39294e0)

1.0.0-alpha.39 (2023-01-20)

Bug Fixes

theme: adjust the position of the curtain to avoid block sidebar (#1816) (48f0b01)
theme: sidebar scrollbar is cropped by nav bar (bd36224)

1.0.0-alpha.38 (2023-01-17)

Bug Fixes

theme: spacing between aside sponsors and ads section is missing (5c2eb1b)

1.0.0-alpha.37 (2023-01-17)

Bug Fixes

build: don't warn on blank lang in fences (99ad162)
theme: prevent vertical scrollbar on code group tabs (#1793) (#1805) (4314b57)

Features

add i18n feature (#1339) (8de2f44), closes #291 #628 #631 #902 #955 #1253 #1381
support for teleports to body (#1642) (09c2c52)
build: don't hard fail on unknown languages in fences (#1750) (1ae0596)
theme: refine overall styles (#1049) (#1790) (471f00a)

1.0.0-alpha.36 (2023-01-11)

Bug Fixes

build: handle cleanUrls without trailing slash (#1772) (2a80fbd)
theme: activeMatch support regexp (#1754) (0913e0f), closes #1771
theme: add cursor for summary of custom block details (#1774) (167a474)
theme: wrap long words in li (#1782) (48a42c1), closes #1783 #1405

Features

allow enhanceApp to return a Promise (#1760) (01ac579)
build: support interpolation inside code blocks (#1759) (3b7ff8d)

1.0.0-alpha.35 (2023-01-03)

Bug Fixes

theme: adjust styles for copied button (#1751) (565ae71)
theme: adjust styles for diff indicator in code blocks (#1755) (a642ea2)
theme: prevent layout shift on carbon ads (f6c5e1f)
theme: refresh ads per page navigation (#1734) (8db20fe)

1.0.0-alpha.34 (2023-01-01)

Bug Fixes

build: dedent of a single-line region (#1687) (7de7fff)
build: handle - in title of code blocks with line highlighting (#1743) (ce9467e)
handle cleanUrls with subfolders when using a trailing slash (#1575) (195d867)

Features

build: allow specifying default language for syntax highlighter (#1296) (f40df31)
build: fence-level config for line-numbers (#1733) (c048076)
theme: add home-hero-image slot (#1528) (e72998b)
theme: add mastodon icon (#1736) (7a73784)
theme: allow adding images as icons in features section (#1738) (9df598f)

Performance Improvements

a11y: make menu traversable only when it is open (#1491) (257f9e6)
preload css to improve loading speed (bf1315a)

1.0.0-alpha.33 (2022-12-21)

Bug Fixes

theme: remove experimental fonts (#1710) (1ebde66)

Features

build: provide a pathname:// protocol to escape SPA (#1719) (ae21a3a)
theme: headings anchor should not be selectable (#1701) (505a4f8)

1.0.0-alpha.32 (2022-12-16)

Bug Fixes

build: fix code groups for line numbers mode (#1700) (135b797)

Features

add code-group feature (#728) (#1560) (a684b67), closes #1242
build: support cacheDir (#1355) (f899764)

1.0.0-alpha.31 (2022-12-10)

Features

build: switch to rollup 3 and vite 4 (#1591) (ae33896)

Performance Improvements

a11y: add aria-hidden to line numbers wrapper (#1675) (4c5a892)

1.0.0-alpha.30 (2022-12-05)

Bug Fixes

build: allow importing files having numbers in extension (#1618) (0565c38)
build: allow serving files in dev from workspace root (#1647) (dc59662)
theme: default to vertical align top on badges inside headings (#1584) (8a488de)
theme: ignore removed diff lines while copying code (f4d5417)
theme: move background colors to theme-default style (#1347) (4f0194f)

Features

build: add preview as an alias for serve in cli (#1651) (4ba33da)

1.0.0-alpha.29 (2022-11-15)

Bug Fixes

build: explicitly specify asset and entry file names (#1607) (8601e15)
theme: typo in attribute name (#1597) (cc91d55)

1.0.0-alpha.28 (2022-11-08)

Bug Fixes

theme: use faux italics only with web fonts (#1581) (124158e)

Features

theme: sidebar nav slots (#1582) (d410d4d)
theme: use v-html in VPDocFooter (#1580) (9d10b1d)

1.0.0-alpha.27 (2022-11-03)

Bug Fixes

build: use addClass from shiki-processor (#1557) (4b0b1ef), closes #1555
build: use default slugify from mdit-vue (#1554) (8cd1f7c)
prevent overlay getting hidden behind navbar (#1547) (87d6c08)
remove shell code copy trailing newline (#1561) (f36cd0d)
theme: use stored preference to be the value of userPreference (#1543) (a7abf73)

Features

theme: add built-in global component Badge (#1239) (ac8619f)
theme: add link feature in homepage features (#984) (#1404) (84b4abc), closes #1070
theme: sort multiple sidebars (#1552) (db1c343)

Reverts

#1530: explicitly exit process after build to prevent hangup (#1572) (01719fa), closes #1530

1.0.0-alpha.26 (2022-10-27)

Bug Fixes

properly apply dark/light classes in code blocks (#1546) (178895f)

1.0.0-alpha.25 (2022-10-25)

Bug Fixes

banner: prevent hidden local nav on scroll (63449ca)

1.0.0-alpha.24 (2022-10-25)

Bug Fixes

banner: broken layout on smaller viewports (#1536) (028cc2c)

1.0.0-alpha.23 (2022-10-25)

Bug Fixes

build: explicitly exit process after build to prevent hangup (#1530) (09fcc46)

Features

build: add useWebFonts option (#1531) (c9f04e0)
support focus, colored diffs, error highlights in code blocks (#1534) (04ab0eb)
theme: add --vp-layout-top-height to adjust banner (#1521) (a29a4a6)

1.0.0-alpha.22 (2022-10-22)

Bug Fixes

types: change ComponentOptions to DefineComponent (#1499) (5711660)

Features

expose isDark (#1525) (d327811)
theme: allow defining dark as the default theme (#1498) (d404753)
theme: support html strings for SidebarGroup headings, SidebarItem text (#1489) (946c579)
transformPageData hook (#1492) (afeb06f)

1.0.0-alpha.21 (2022-10-14)

Bug Fixes

build: better align server and client side filename sanitization (3fd20fe)
theme: match switch background transition with page transition (#1479) (962065a)
theme: prevent body scrolling when sidebar has opened on small screens (#1391) (3daabdc)

Features

theme: allow specifying common alt for logo (#1451) (55688a8)

1.0.0-alpha.20 (2022-10-12)

Bug Fixes

a11y: add title to copy code button (#1437) (f79bb78)
router: don't intercept download links (#1452) (54cf6ce)
theme: disable transitions on theme toggle (#1447) (067e1a9)
theme: make text prop of VPHero optional (#1445) (95e4f2a)

Reverts

"fix(build): remove leading underscore from chunks" (#1471) (18f0fb4)

1.0.0-alpha.19 (2022-10-02)

Bug Fixes

build: ignore tsconfig target in dev (#1428) (a13bc86)

1.0.0-alpha.18 (2022-10-01)

Bug Fixes

theme: break long words on overflow (#1405) (2114d13)

1.0.0-alpha.17 (2022-09-27)

Bug Fixes

theme: add cursor for collapsible sidebar title (#1397) (ed37b9a)
theme: remove extra space before docsearch key (#1396) (6cb79bb)

Reverts

#1064 (9d70ca5)

1.0.0-alpha.16 (2022-09-24)

Bug Fixes

build: line numbers mode when language specifier has symbol (#1353) (9c04a10)
build: remove leading underscore from chunks (#1394) (66cd164)
compat: use default export of dns module (#1388) (fa6fa56)
theme: always add alt attribute to images (#1348) (a621c69)

Features

build: allow using transformIndexHtml (#1380) (ce8d139)

1.0.0-alpha.15 (2022-09-15)

Bug Fixes

build: properly resolve node_modules (#1337) (0672a69)
theme: hide extra navbar when no content (#1338) (4482c50)
theme: remove trailing # from outline (#1344) (f1cf1e8)

1.0.0-alpha.14 (2022-09-14)

Bug Fixes

prevent jumping on clicking docsearch action buttons (#1140) (86413e6)
theme: break long words (#1064) (9c739fd)
theme: don't nest sidebar links (#1279) (f840dbc)
theme: keep display copied hint when click multiple times (#1262) (bb11d0f)
theme: show progress bar after delay (#1278) (496bd34)
theme: use pointer cursor only on enabled buttons (#1300) (d7eac98)
theme: use pointer-events auto instead of all (#1290) (6fac5b2)
types: allow non async transformHtml and buildEnd (#1270) (ee37eaa)

Features

add transformHead hook (#1323) (6b16dad)
add vp-raw container (#1104) (9a6e1ea)
bundle type definitions of dev-deps (#1257) (12591a9)
theme: add page load progress bar (#1264) (ecf5515)
theme: allow disabling whole layout (#1268) (8f63033)
theme: support dynamic headers and nesting in outline (#1281) (288aa48)

Performance Improvements

a11y: add aria-checked attribute to switch (#644) (eb9026d)
render pages asynchronously (#1320) (8e4ff4d)

Reverts

#1264: add page load progress bar (#1311) (5378a49), closes #1264

1.0.0-alpha.13 (2022-08-30)

Features

use global delegation for copy code interaction (b5bd73f)

1.0.0-alpha.12 (2022-08-26)

1.0.0-alpha.11 (2022-08-26)

Features

support markdown sfc options (#1238) (d700a66)

1.0.0-alpha.10 (2022-08-22)

Bug Fixes

avoid circular deps when extending default theme + importing feature components (5fb7948), closes #1210

Features

build: support markdown frontmatter options (#1218) (bfb0220)

1.0.0-alpha.9 (2022-08-20)

Bug Fixes

theme: fix typo in carbon ads components (#1192) (e0932ce)
theme: show footer message/copyright only if present (#1191) (da2f8d2)
theme: show outline even without sidebar (#1189) (3714ea3)
types: explicitly re-export to resolve ambiguities (#1193) (eacc18c)
use junctions in Windows (#1217) (0e14211)

Features

theme: extend titleTemplate by replacing the title (#1200) (c7def73)

1.0.0-alpha.8 (2022-08-17)

Bug Fixes

fix client build entry (04c4d0f)

1.0.0-alpha.7 (2022-08-17)

Bug Fixes

fix static data file support in vite 3 (19ec22c)

1.0.0-alpha.6 (2022-08-17)

Breaking Changes

/@theme import alias has been removed. Use @theme instead.

Bug Fixes

theme: remove extra padding in code blocks with line numbers (f6d6c62)
theme: restore styles for code blocks (#1170) (2c89afb)
theme: set pointer events all on VPNavScreen (#1182) (b36656a)

Features

build: switch to vite 3, support clean urls and esm mode (#856) (0048e2b)

1.0.0-alpha.5 (2022-08-16)

Bug Fixes

build: cache key should consider file path (#948) (1daeaa1)
build: handle vite constants replacement (#419) (#888) (9d9db62)
build: recreate server on config change (#1132) (93fe820)
build: show workaround on encountering dead links (#822) (#868) (29d44e7)
build: strip custom anchor with capital letters in outline (#1005) (f6d5697)
build: update language regex for line number class (#1108) (708c361)
can't detect that the page has scrolled to the bottom (#956) (#970) (98e45af)
de-duplicate head tags while merging (#975) (#976) (f7e9cfe)
decode href before using as query selector (#951) (22006e8)
decode image src so that rollup can process it (#933) (bb41a9f)
don't add base to external urls while preloading (#1045) (7295033)
don't change url hash while scrolling (#991) (0826944)
layout inconsistencies and remove sidebar from 404 page (#964) (0257ea8)
line highlighting in custom code block (#959) (#969) (7a9e4d9)
normalize link in VPButton (#919) (bed68f1)
only check for duplicate meta tags (#977) (1ef7a18), closes /github.com/vuejs/vitepress/issues/975#issuecomment-1183507200
regression caused by #887 (30249dc)
remove duplicate router logic (#1087) (63584c2)
remove explicit noopener from external links (#871) (e4c60ab)
support urls with query during dev (35b7361)
theme: change sponsor link class name to bypass adblock (#866) (#867) (e33955e)
theme: close menu on route change (#887) (fcd7642)
theme: don't let navbar obstruct clicks to top part of scrollbar (#1168) (44953dc)
theme: fix custom NotFound component rendering (#1163) (4a6eda4)
theme: hide doc footer if empty (#1126) (70da5f2)
theme: make last updated time reactive (#879) (25a835f)
theme: navbar menu may exceed the screen (#988) (#989) (8a46413)
theme: prevent docsearch button key from changing (#986) (d65667b)
theme: tweak styles of nav title (#962) (#968) (d91f3b1)
theme: typo in color name (#1020) (4b38736)
treat all URI schemes as external (#945) (#946) (1e9a7ac)
types: add client and theme to exports field (#914) (1cc087d)
types: fix broken syntax in theme.d.ts (#1101) (70b3060)
use router.go if search string is not same (#1109) (5597165)

Features

allow adding custom social icons as inline svg (#738) (#953) (74e4950)
allow html in footer (#1034) (ad9af83)
allow using custom syntax highlighting themes (#992) (d5ed66c)
build: allow ignoring dead links (#586) (#793) (19b0758)
build: allow using custom highlighter (#754) (#857) (ddf876d)
build: handle change of config file dependencies (#1009) (8e6665b)
build: improve code blocks and snippets (#875) (f789932), closes #861 #471 #884
build: support code highlight in uppercase (#1082) (867f305), closes #772
provide transformHtml hook (#1022) (2b4b800)
provide build end hook (#709) (e0b730a)
theme: add doc-footer-before slot (#1050) (#1052) (60c515c)
theme: add navigation slots (#739) (#741) (0f0453c)
theme: add option to customize search button text (#713) (#747) (00fe809)
theme: auto open collapsed sidebar on entering (#1094) (f4f1a6c)
theme: custom prev/next labels and text (#897) (836a246)
theme: support hiding aside component from frontmatter (#980) (69ef299)
theme: support multi-level sidebar (#851) (d1a2c76)

Performance Improvements

a11y: change copy code span to button (#1056) (fb9cee9)

Reverts

vuejs/vitepress#889 (#896) (e1339fd)

1.0.0-alpha.4 (2022-06-22)

Bug Fixes

theme: home image style is broken in big view port (2bd960d)

1.0.0-alpha.3 (2022-06-22)

Bug Fixes

theme: italic fonts are missing (#759) (#777) (fa00c83)
theme: copy code in non-secure contexts (#792) (2935ed2)
theme: copy code button has wrong tag closing syntax (#816) (75ca9e4)
theme: edit link gets hidden when a page don't have siblings (#751) (9bc4330)
theme: nav close icon not working correctly (#744) (75c9d80)
theme: sidebar is shown on home layout (#825) (#829) (42cbd31)
theme: sidebar collapsed option not working on layout change (#809) (#811) (7737699)
theme: DefaultTheme type causes error in some cases (#804) (107724a)

Features

build: allow setting base from command line (2952638)
theme: add active status to nav menu group (#820) (fdb5720)
theme: add global layout slots (#760) (#812) (1f1e298)
theme: support themeable images for logo and hero (#745) (42813ce)
theme: add team page feature (#828) (7cfe0f0)

1.0.0-alpha.2 (2022-06-14)

Bug Fixes

use h1 for title in hero instead of p (#776) (919d230)
add background color in navbar to avoid contrast issues (#695) (305bcc0)
add default value for base in createMarkdownRenderer (#555) (#556) (78a2e84)
allow lang='ts' on scripts in markdown (#693) (#701) (59df105)
better nav item types (#714) (263607b)
double base in sidebar links (#756) (aa65cb5)
use pre-wrap for text and tagline (#746) (94704c9)
nav nested items type error (#710) (#711) (e5bf15a)
page layout breaks when page name matches the css class name (#696) (#699) (9c0ed93)
remove title bg transition to avoid flush on sidebar on/off (1942418)
sidebar right blur notch (#712) (64c3654)
typo (#708) (#716) (1fe5153)
title in containers not working with markdown content (#765) (#768) (c5c3c64)
use base in links (#717) (#718) (8e50154)
use h2 for feature headers (#774) (b1ff725)

Features

add lastUpdated option to frontmatter (b31fbf3)
add doc before and after slot (#762) (#786) (9c2a36f)
allow custom edit links (#698) (535e176), closes #694 #697
allow custom outline title (#689) (#690) (a8a1623)
allow external links in sidebar (#205) (#686) (ce17f50)
support custom content in home layout (#702) (92659a2)
emit 404.html on build (#729) (#740) (23276ba)
setup devtools and remove debug component (#721) (421f641)

1.0.0-alpha.1 (2022-06-01)

Complete rewrite on default theme, with bunch of features added. Please refer to the docs for the new feature and changes.

0.22.4 (2022-05-06)

Bug Fixes

plugin: set content-type header for serving index.html (#616) (1656f03)
remove 404 from title on initial route (#590) (216e129), closes #589

0.22.3 (2022-02-22)

Bug Fixes

append base to links (#502) (804954c), closes #252
avoid minimizing non-javascript inline scripts (#517) (779b789), closes #538 #540
client router: tolerant invalid hash selector typo (#506) (ffe0c40)
don't add .html to urls of non-html files (#515) (34d1542), closes #265
normalize relative img src (#514) (9270477), closes #450
require at least node v14 (#546) (7cf7011)
reset page data on 404 (#497) (28eaa3b)

0.22.2 (2022-02-14)

Features

improve default chunk strategy + page hash stability (1ef69e2)

0.22.1 (2022-02-14)

Features

automatically update hash map + retry on failed page fetch (2324948)
use git-based lastUpdated data (d32d8d4)

Note: lastUpdated data is now disabled by default due to the performance overhead of retrieving the git information. This also means each page's metadata object no longer contains the lastUpdated property by default - it will only be present if the new lastUpdated: true config option is enabled.

0.22.0 (2022-02-11)

Upgrade to Vite 2.8

0.21.6 (2022-01-19)

Perf

Avoid wrapping siteData as readonly proxy in production builds

0.21.5 (2022-01-16)

Bug Fixes

allow overriding title if home is true (#493) (88d57a9)
types: fix vitepress/theme type (eabf6d2), closes #489 #438 #494 #442

Features

scrollOffset option (b66785d)

0.21.4 (2022-01-07)

Bug Fixes

set __data in md.render (dfbc932)

0.21.3 (2022-01-06)

Bug Fixes

prioritize vue installed in user project root (9b3243b)

0.21.2 (2022-01-06)

0.21.1 (2022-01-06)

Performance Improvements

do not include head config in client bundle for production (6f3a96f)

0.21.0 (2022-01-06)

Bug Fixes

Chinese file link build failed (#425) (ae029ae), closes #424
initial render of 404 pages (#418) (a3bf52f)
remove . for mjs in supportedConfigExtensions (#447) (fb6a4ad)
serve: respect base config in serve mode (#470) (08a0b12), closes #416
set tempDir outside package root (#439) (bd35451), closes #435
use algolia search lang (#459) (444562c)

Features

add details custom container (#455) (a8f147f)
catch localhost links as dead links (7387649)
expose __path and __relativePath on md instance for md plugins (4cec660)
improve typescript support for config file, add defineConfigWithTheme (#465) (ba41bb9)
properly remove {#custom-anchor} syntax in headers (6120da2)
user configurable outDir (#448) (5b04bb9)

0.20.10 (2021-12-25)

Features

minify head inline scripts (e61db62)

0.20.9 (2021-12-15)

Features

shouldPreload hook (e721d60)
support array of patterns in data loaders (f5308d7)

0.20.8 (2021-12-14)

0.20.7 (2021-12-14)

Features

types: re-export vite client type (4caa7b2)

0.20.6 (2021-12-14)

Features

support static data loaders (26fe81c)

0.20.5 (2021-12-12)

Bump vue & vite versions

0.20.4 (2021-12-07)

Bug Fixes

build: fix typing files (ae11dc0)

0.20.3 (2021-12-07)

Features

expose createMarkdownRenderer (d54c7d8)

0.20.2 (2021-12-06)

Bug Fixes

handle potential string quote mismatch in generated code (dfa7c05)
improve createStaticVNode match for rollup codegen compat (abb1b57)
lazy require @vitejs/plugin-vue to respect NODE_ENV (a051e66)
static string strip regex for mulitiline static strings (bc486aa)

Features

upgrade docsearch version (#441) (1b245e2)

0.20.1 (2021-11-05)

Bug Fixes

hmr: avoid relying on revertd vite hmr behavior (4114674)

0.20.0 (2021-10-07)

Bug Fixes

fix code line hightlighting (4c042b6), closes #408
invalid active props when base option is added (#342) (383d8ff)
make config hmr work in window (#364) (58663bb)
print urls again (df69b76)
support vite plugins provided via config.vite (#394) (4b76617)
theme-default/algolia: avoid creating multiple algolia searches (#292) (389e863)
theme: fix algolia search filter (5fd7db2)
tolerant invalid hash (#399) (efc5e1b)

Features

support ts/esm config file + defineConfig() helper (d3b1521), closes #339 #376
theme-default: home slot for customizing the entire homepage easily (#314) (07bf145)

0.19.2 (2021-09-28)

Bug Fixes

encode urls that conflict w/ vite built-in replacements (3940625)

0.19.1 (2021-09-21)

Fix build

0.19.0 (2021-09-21)

Features

upgrade vue, simplify deps (9030486)
use markdown-it-attrs for markdown-it plugins (#393) (610e9b7)

0.18.1 (2021-09-16)

Bug Fixes

ensure stable pages entry order across builds (929bcf5)

0.18.0 (2021-09-14)

Features

map mode + remove deprecated options (b94b163)
support <script client> in mpa mode (e0b6997)

0.17.3 (2021-09-09)

Bug Fixes

emit prevented hashchange event (4fb387d)

0.17.2 (2021-09-08)

Bug Fixes

improve fs allow (2e9264f)

Features

support config.extends (f749b27)

0.17.1 (2021-09-08)

Bug Fixes

avoid using spread for client code (03abee7)
default-theme: use description as tagline by default (b94c827)
handle case when there is no themeConfig (034c737)

Performance Improvements

minor optimizations (96bcdda)

0.17.0 (2021-08-31)

Bug Fixes

allow vite server access to theme and local files (9b9fdc7)
code: code block highlight bug in ul (#352) (9245226)
css: remove 720px breakpoint in home layout (#347) (0c1a1f2)
i18n: fix locales reading, add site.langs (#353) (bc78adb), closes /vuepress.vuejs.org/guide/i18n.html#site-level-i18 /v2.vuepress.vuejs.org/guide/i18n.html#site-i18
include emoji text in nav link to match toc (#284) (80ff360)
use useData() instead of $site (#365) (1e64773)

Features

support function config (e74c5f0)
support partial include directive (7b3a9e5)
upgrade markdown-it-anchor (#350) (26b5aa9)

BREAKING CHANGES

the markdown.anchor option is updated. Refer to valeriangalliat/markdown-it-anchor#permalinks for instructions to upgrade your existing markdown.anchor.permalink option. This doesn't affect you if you weren't changing the header permalinks behavior.

0.16.1 (2021-08-11)

Features

info custom container (4925fb5)

0.16.0 (2021-08-10)

This version uses Vue 3.2.0.

Bug Fixes

override target and rel links attribute in config (#332) (9d98dbb)
edit-link: let frontmatter overwrite global editLink (#340) (cfbba80)

0.15.6 (2021-07-02)

Bug Fixes

automatically escape vite user defined variables in markdown (3cec536)
skip external URLs in withBase (#328) (53bb961)

0.15.5 (2021-06-23)

Bug Fixes

nav: display nav if locales are present (#321) (e76e6ec)
search: correctly detect multilang (c046905), closes #316

Performance Improvements

only update necessary head tags in prod (e6bb5a4)

0.15.4 (2021-06-19)

Bug Fixes

avoid scroll behavior reliance on .nav-bar class (9b35dfc)

0.15.3 (2021-06-15)

Bug Fixes

avoid error when theme does not have .nav-bar class (a9d5800)
avoid resetting head tags on hmr/page switch (f52f20e)
watch config file when using srcDir (348f19a)

0.15.2 (2021-06-15)

Bug Fixes

force optimize vue to avoid duplication when linked (eefba39)

0.15.1 (2021-06-14)

Features

support passing vite config in vitepress config file via vite option (3737b10)
support srcDir config option (aaf4910)

Performance Improvements

avoid double resolve user config on startup (5733fc6)

BREAKING CHANGES

Some config options have changed.
- vueOptions renamed to vue
- alias option has been removed. Use vite.resovle.alias instead.

0.15.0 (2021-06-14)

Bug Fixes

fix frontmatter sidebarDepth for headers (424a4ca)
fix vue code block type indication (76fa173)

Features

more efficient useData() method that exposes all data (0661063)

BREAKING CHANGES

The following methods are removed.

useSiteData
useSiteDataByRoute
usePageData
useFrontmatter

Instead, use the new useData() method:

// before
import { useSiteDataByRoute, usePageData } from 'vitepress'
const site = useSiteDataByRoute()
const page = usePageData()
const theme = computed(() => site.value.themeConfig)

// after
import { useData } from 'vitepress'
const { site, page, theme } = useData()

All destructured values are computed refs injected from app root so they are created only once globally.

All global mixin properties (e.g. $site) except $frontmatter are removed. Always use useData() to retrieve VitePress data in Vue components.

0.14.1 (2021-06-08)

Bug Fixes

functional templates with vue v3.1 (#312) (8988aad)

0.14.0 (2021-05-27)

Bug Fixes

chinese filenames can't build (#217) (#262) (b940397)
theme: set search box min-width for >=751px (#286) (9589a5d)
detect public folder for dead link (#290) (3aa185f)
remove unnecessary 'vite/dynamic-import-polyfill' (6b4a4aa)

Features

Vite version bumped to ^2.3.4
exclude option (#281) (71a5e1c)
Render titles for social sharing and improve home page sharing (#263) (e651f97)

0.13.2 (2021-04-26)

Bug Fixes

search: silence warning for prop (0716ffa)

0.13.1 (2021-04-26)

Bug Fixes

locales: use correct lang (#283) (de89c1e)

0.13.0 (2021-04-08)

Bug Fixes

build fails without css chunks (#209) (#239) (fa469fd)
css: reuse css vars (#256) (8d91524)
docs: global-component link (#271) (a43933c)
locales: use correct lang (#276) (f505db9)
navbar: use css var for background-color (#264) (f385bc4)
badge for language-javascript (#245) (f8b4aa5)

Features

detect dead links (74f5ada)
import code snippet with region (#237) (#238) (d1a62e1)

0.12.2 (2021-02-15)

Bug Fixes

theme-default: avoid ad image distortion on mobile (4a40e1f)

0.12.1 (2021-02-15)

Bug Fixes

@ alias for import code snippet being always undefined (#204) (2aa8ab2)
base option not generating correct multi sidebar (#231) (#234) (a613df4)
ads display causing layout break in mobile view (#230) (7ceaf34)
home action link not being reactive (#195) (#212) (5678dc3)
nav home title not having locale based link (#195) (#233) (6538c8e)

0.12.0 (2021-02-09)

Bug Fixes

base option not working on dev mode (#223) (0b5b306)
frontmatter description duplication (#194) (#170) (338e845)
sidebar 'auto' not working (#178) (#224) (5deaf6a)
render document with standards mode in dev (#207) (8a0db65)
utf-8 character not working on safari in dev mode (#228) (b82d8f2)
use brand color in algolia search box (2330023)

Features

add vue options config (expose @vitejs/plugin-vue) (#215) (5b34c6a)

BREAKING CHANGES

If sidebar option is undefined it will be treated as auto, where previsouly it looked like it was treated as false. It was always treated as auto, but due to this bug, the sidebar was hidden, therefore it looked like it was treated as false.

0.11.5 (2021-01-29)

Bug Fixes

avoid layout shift due to ads (#176) (78b026c)
support symbolic links in building docs dist (#184) (#185) (5190604)
update base option usage (8cfdd19)

Features

$lang and $localePath globals (#166) (#167) (481c451)

0.11.4 (2021-01-19)

Latest Vite beta.32 compat (internal changes).

0.11.3 (2021-01-13)

Bug Fixes

ignore non-html links in router and prefetch (3e6e61b)

0.11.2 (2021-01-12)

Bug Fixes

aria label id (a0f463a)

Performance Improvements

generate preload directives for dynamicImport chunks too (b9fc0cb)

0.11.1 (2021-01-12)

Features

render content on home page (ca631c7)

0.11.0 (2021-01-12)

Code Refactoring

move default theme to 'vitepress/theme' (a79e1e1)

Features

support customData in config (4072dc5)

BREAKING CHANGES

the default theme is now exposed via 'vitepress/theme', instead of a named export from 'vitepress'. This change fixes the case where when a completely custom theme is used, importing anything from 'vitepress' also imports the entire default theme.

0.10.8 (2021-01-11)

Bug Fixes

resolve page hash case-insenstively, close #202 (#203) (bac1ce2)

0.10.7 (2021-01-05)

Features

Bump to Vite 2.0.0-beta.8

Bug Fixes

scrollbar when using line highlight (#200) (b6ba8a9)

0.10.6 (2021-01-04)

Bug Fixes

bump vite and fix win32 path resolving (#198) (da2c4f6)

0.10.5 (2021-01-02)

Bug Fixes

vite 2.0.0-beta.2 compat (991a443)

0.10.4 (2021-01-01)

Bug Fixes

ensure the same vue dep in all cases (d6b8568)
respect root during build (055e3fd)

0.10.3 (2021-01-01)

Bug Fixes

always define theme globals (8769b4b)
avoid unexpected vite define replacements in markdown content (a41928e)
loosen navLink active matching (8a2ff33)

Features

theme-default: nav.item.activeMatch (e262ef6)
add altAction for home (9a17ddf)

0.10.2 (2020-12-31)

Bug Fixes

adjust multi sidebar matching logic (7e4b16e)

0.10.1 (2020-12-30)

Bug Fixes

disable css code split (04dc058)
minify (e3d7fc0)

Features

production ready serve (2d77eaf)

Performance Improvements

avoid including optional features in build when not used (c878e6d)

0.10.0 (2020-12-30)

Upgrade to Vite 2.0

Bug Fixes

port fixes to parseHeader utils from vuepress (#172) (dd312ce)
revert datetime handling (a1daf2b)
style pollution on custom theme (#190) (46e99ba)
temporarily disable slot usage causing hydration mismatch (0239159)
md: avoid normalising markdown "mailto:" links (#173) (18d18d2)

0.9.2 (2020-12-10)

Fix build files

0.9.1 (2020-12-05)

Bug Fixes

theme: the actionLink miss withBase (#168) (#169) (ffaca73)
align $title with vuepress (#158) (#163) (30740d3)
fix h2 anchor hover (9bd79e8), closes #174
fix inline code not inheriting the parent font size (f5a570f)
fix link prefetch (ade6ddd)
hydration mismatch when home page having action link (a7686b7)
make home page look better (#154) (a084cd3)
prevLinks and nextLinks config type (#165) (1b6981a)
siteData passed to enhanceApp being siteDataByRoute (#159) (01d2837)

Features

built-in ClientOnly component (8809d2d)
default-theme: support customLayout: true in frontmatter (f32771f)
add $withBase global app function (15e18df)
add Algolia DocSearch (#40) (#153) (5bb4730)
add native support for carbon ads (#86) (9d6b8ca)
support customizing default theme via slots (b8e892e)
add more global and computed properties (#152) (c6bdcfb), closes #152

0.9.0 (2020-11-24)

Bug Fixes

avoid 300ms click delay on touch devices (621ca3e)
fix nested list having too much margin (b0cf2be)
fix sidebar active status not working as expected (#140) (#149) (0b181e7)
make code block look prettier (#146) (242fcc1)
some color in code block not working as expected (#143) (da09266)

Features

add "last updated" feature (40d204b)

0.8.1 (2020-11-20)

Bug Fixes

fix "next and prev link" not working when link has extention (6dcf6b3)
fix "next and prev links" not working when the base option is set (#139) (018a9b4)

0.8.0 (2020-11-20)

Bug Fixes

exit process with non-zero code on error (fb09f8e)
fix edit link and prev and next links display (#97) (c3b7172)
fix next and prev links not working (#130) (fdd498b)
display header-anchor links when using keyboard navigation (ddc3640)
show top part of scrollbar in sidebar (#129) (1ba209a)

Features

add ability to configure markdown options (#127) (#128) (463a03a)
add serve command (#136) (67868bd)
better build command output (e435eec)

0.7.4 (2020-11-11)

Bug Fixes

css: fix padding on mobile (9c7293b), closes #121

0.7.3 (2020-11-06)

Bug Fixes

Fix sidebar page switch layout shifting
Fix production hydration mismatch

0.7.2 (2020-11-02)

Bug Fixes

adapt to vite fix of ssr build asset paths (6b3fbe3)

Features

add home page feature (#108) (3a0af0b)

0.7.1 (2020-10-30)

Bug Fixes

compat with latest vite + handle no export default script tags in md (b10da2f)
fix switch language error (#103, #106) (#104) (d354d1e)

0.7.0 (2020-10-19)

Bug Fixes

css: theme specific (6891092)
router: remove fakeHost when fixing url extenions (2eb3135)

Features

client: add slot for a searchbar (68d9b18)
i18n: add nav dropdown language selector feature (#91) (294836c)
sidebar: close when navigating (2094d53)
add doctype html (02f2e10)
add some space between 2 code blocks (5daa8d2)

0.6.0 (2020-09-17)

Bug Fixes

client: use relative import (725a04c)
links: keep relative hash links as is (a90d971)
router: allow open new tab with ctrl + click (#69) (092ee77)
sidebar: no margin on mobile (#89) (218c729)
sidebar not working correctly when path starts with slash (610cc17)
sidebar: fix sidebar when you open a nested link (#73) (d2b6d39)

Features

add blockquote styling (8c1aada)
add charset and viewport meta tags (#77) (2e8e1f5)
add git repo link and edit links (#55) (0ea34cb)
add prev/next links (#56) (f52b1d5)
add responsive sidebar support (#75) (39dbd78)
add table css from vuepress (#88) (8435e36)
close the sidebar when clicking outside of the sidebar (#78) (e93ee09)
navlinks in sidebar (#80) (a20bcf3)
overwrite prev/next link (#61) (1b96f63)
support config alias (#59) (63a3691)
top and bottom slots for sidebar and page (#90) (1106013)
sidebar: use base when creating link (#74) (79bc9fb)

0.5.0 (2020-07-21)

Bug Fixes

decode hash before selecting (e782c4c)
fix navbar withBase (e9ab56b)
typings field in package.json (#48) (692a490)

Features

add external link support for nav items (#46) (44e91bb)
add multi sidebar support (#38) (#49) (050fa4c)
i18n support (#50) (7802cb5)
nav dropdown (#51) (5780461)

0.4.1 (2020-07-02)

Bug Fixes

avoid error when requesting non-existing md file (e77ea63)
resolve relative path on windows (#27) (9116c9c)
use resolve instead of join (#33) (6f10ed6)

Features

add array sidebar support (#35) (4a8388e)

0.4.0 (2020-06-19)

0.3.1 (2020-06-05)

Bug Fixes

avoid using DEV + throttle active header link (a63b0cf)

0.3.0 (2020-06-02)

Bug Fixes

lazy load @vue/server-render for production build (382e1b6)

Features

active sidebar links (d2ea963)

0.2.0 (2020-05-22)

Bug Fixes

avoid unnecessary prefetches (0a81525)
handle links that embed other elements (#2) (4cbfc60)

Features

copy public dir (ddc9d51)
lean builds (b61e239)
prefetch in viewport inbound page chunks (da4852a)
use hashed page file names (a873564)
use modulepreload links (0025af1)

Performance Improvements

inject script tags for page common chunk imports (57d900d)

0.1.1 (2020-04-30)

fix dependency versions

0.1.0 (2020-04-30)

Features

add markdown processing (5c47bbb)
spa navigation (21d3cd8)
update head tags during dev (bdbbdd5)
update title & description during dev (0b9bf27)

Files

CHANGELOG.md

Latest commit

History

CHANGELOG.md

File metadata and controls

1.0.0-alpha.60 (2023-03-15)

Features

1.0.0-alpha.59 (2023-03-15)

Bug Fixes

Features

1.0.0-alpha.58 (2023-03-14)

Bug Fixes

1.0.0-alpha.57 (2023-03-14)

Bug Fixes

Features

Performance Improvements

BREAKING CHANGES

1.0.0-alpha.56 (2023-03-13)

Bug Fixes

1.0.0-alpha.55 (2023-03-13)

Bug Fixes

Performance Improvements

1.0.0-alpha.54 (2023-03-13)

Bug Fixes

1.0.0-alpha.53 (2023-03-13)

Bug Fixes

Features

1.0.0-alpha.52 (2023-03-11)

Bug Fixes

Features

Performance Improvements

BREAKING CHANGES

1.0.0-alpha.51 (2023-03-09)

Bug Fixes

Features

Performance Improvements

1.0.0-alpha.50 (2023-03-07)

Bug Fixes

Features

1.0.0-alpha.49 (2023-02-28)

Bug Fixes

Features

1.0.0-alpha.48 (2023-02-26)

Bug Fixes

Features

1.0.0-alpha.47 (2023-02-20)

Bug Fixes

Reverts

1.0.0-alpha.46 (2023-02-12)

Bug Fixes

Features

BREAKING CHANGES

1.0.0-alpha.45 (2023-01-31)

Bug Fixes

1.0.0-alpha.44 (2023-01-31)

Bug Fixes

Features

BREAKING CHANGES

1.0.0-alpha.43 (2023-01-29)

Bug Fixes

1.0.0-alpha.42 (2023-01-29)

Bug Fixes

1.0.0-alpha.41 (2023-01-28)

Bug Fixes

Features

1.0.0-alpha.40 (2023-01-20)

Bug Fixes

1.0.0-alpha.39 (2023-01-20)

Bug Fixes

1.0.0-alpha.38 (2023-01-17)

Bug Fixes

1.0.0-alpha.37 (2023-01-17)

Bug Fixes

Features

1.0.0-alpha.36 (2023-01-11)

Bug Fixes

Features

1.0.0-alpha.35 (2023-01-03)

Bug Fixes