From b0bf107111c9d8e65c51926145883d21d8e5a983 Mon Sep 17 00:00:00 2001 From: sendevia Date: Fri, 26 Sep 2025 00:33:56 +0800 Subject: [PATCH] =?UTF-8?q?misc:=20=E6=9D=82=E9=A1=B9=E4=BC=98=E5=8C=96?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .vitepress/config.ts | 3 +- .vitepress/theme/layouts/Default.vue | 4 +- .vitepress/theme/layouts/SearchPosts.vue | 8 +- .vitepress/theme/styles/main.scss | 2 - package.json | 1 + posts/api-examples.md | 1 + posts/markdown-examples.md | 6 + posts/markdown-it.md | 234 +++++++++++++++++++++++ 8 files changed, 250 insertions(+), 9 deletions(-) create mode 100644 posts/markdown-it.md diff --git a/.vitepress/config.ts b/.vitepress/config.ts index c1cb63d..c07cc34 100644 --- a/.vitepress/config.ts +++ b/.vitepress/config.ts @@ -1,5 +1,6 @@ import { defineConfig } from "vitepress"; -import packageJson from "../package.json" with { type: "json" }; +import packageJson from "../package.json"; +import markdownItAnchor from "markdown-it-anchor"; // https://vitepress.dev/reference/site-config export default defineConfig({ diff --git a/.vitepress/theme/layouts/Default.vue b/.vitepress/theme/layouts/Default.vue index 5c62455..1b98556 100644 --- a/.vitepress/theme/layouts/Default.vue +++ b/.vitepress/theme/layouts/Default.vue @@ -10,7 +10,7 @@ const { site, page, frontmatter } = useGlobalData(); diff --git a/.vitepress/theme/styles/main.scss b/.vitepress/theme/styles/main.scss index 84666ea..0d0c055 100644 --- a/.vitepress/theme/styles/main.scss +++ b/.vitepress/theme/styles/main.scss @@ -13,11 +13,9 @@ @include meta.load-css("_components/card"); @include meta.load-css("_components/code"); @include meta.load-css("_components/dialog"); -@include meta.load-css("_components/footer"); @include meta.load-css("_components/header"); @include meta.load-css("_components/layout"); @include meta.load-css("_components/loading-splash"); -@include meta.load-css("_components/navigation"); @include meta.load-css("_components/notfound"); @include meta.load-css("_components/snackbar"); @include meta.load-css("_components/table"); diff --git a/package.json b/package.json index 6affc36..bea0b6b 100644 --- a/package.json +++ b/package.json @@ -1,4 +1,5 @@ { + "version": "0.0.1", "scripts": { "docs:dev": "vitepress dev", "docs:build": "vitepress build", diff --git a/posts/api-examples.md b/posts/api-examples.md index 7ef13ad..1bbe55b 100644 --- a/posts/api-examples.md +++ b/posts/api-examples.md @@ -1,5 +1,6 @@ --- outline: deep +impression: /assets/images/116014672_p0.webp --- # Runtime API Examples diff --git a/posts/markdown-examples.md b/posts/markdown-examples.md index f9258a5..8b23f88 100644 --- a/posts/markdown-examples.md +++ b/posts/markdown-examples.md @@ -1,3 +1,9 @@ +--- +date: 2025-09-22 +title: Markdown Extension Examples +description: This page demonstrates some of the built-in markdown extensions provided by VitePress. +impression: /assets/images/100628112_p0.webp +--- # Markdown Extension Examples This page demonstrates some of the built-in markdown extensions provided by VitePress. diff --git a/posts/markdown-it.md b/posts/markdown-it.md new file mode 100644 index 0000000..49ee91b --- /dev/null +++ b/posts/markdown-it.md @@ -0,0 +1,234 @@ +--- +__Advertisement :)__ + +- __[pica](https://nodeca.github.io/pica/demo/)__ - high quality and fast image + resize in browser. +- __[babelfish](https://github.com/nodeca/babelfish/)__ - developer friendly + i18n with plurals support and easy syntax. + +You will like those projects! + +--- + +# h1 Heading 8-) + +## h2 Heading + +### h3 Heading + +#### h4 Heading + +##### h5 Heading + +###### h6 Heading + +## Horizontal Rules + +___ + +--- + +*** + +## Typographic replacements + +Enable typographer option to see result. + +(c) (C) (r) (R) (tm) (TM) (p) (P) +- + +test.. test... test..... test?..... test!.... + +!!!!!! ???? ,, -- --- + +"Smartypants, double quotes" and 'single quotes' + +## Emphasis + +**This is bold text** + +**This is bold text** + +*This is italic text* + +*This is italic text* + +~~Strikethrough~~ + +## Blockquotes + +> Blockquotes can also be nested... +>> ...by using additional greater-than signs right next to each other... +> > > ...or with spaces between arrows. + +## Lists + +Unordered + ++ Create a list by starting a line with `+`, `-`, or `*` ++ Sub-lists are made by indenting 2 spaces: + + Marker character change forces new list start: + + Ac tristique libero volutpat at + + Facilisis in pretium nisl aliquet + + Nulla volutpat aliquam velit ++ Very easy! + +Ordered + +1. Lorem ipsum dolor sit amet +2. Consectetur adipiscing elit +3. Integer molestie lorem at massa + +1. You can use sequential numbers... +1. ...or keep all the numbers as `1.` + +Start numbering with offset: + +57. foo + +2333333333 + +999. bar + +## Code + +Inline `code` + +Indented code + + // Some comments + line 1 of code + line 2 of code + line 3 of code + +Block code "fences" + +``` +Sample text here... +``` + +Syntax highlighting + +``` js +var foo = function (bar) { + return bar++; +}; + +console.log(foo(5)); +``` + +## Tables + +| Option | Description | +| ------ | ----------- | +| data | path to data files to supply the data that will be passed into templates. | +| engine | engine to be used for processing templates. Handlebars is the default. | +| ext | extension to be used for dest files. | + +Right aligned columns + +| Option | Description | +| ------:| -----------:| +| data | path to data files to supply the data that will be passed into templates. | +| engine | engine to be used for processing templates. Handlebars is the default. | +| ext | extension to be used for dest files. | + +## Links + +[link text](http://dev.nodeca.com) + +[link with title](http://nodeca.github.io/pica/demo/ "title text!") + +Autoconverted link (enable linkify to see) + +## Images + +![Minion](https://octodex.github.com/images/minion.png) +![Stormtroopocat](https://octodex.github.com/images/stormtroopocat.jpg "The Stormtroopocat") + +Like links, Images also have a footnote style syntax + +![Alt text][id] + +With a reference later in the document defining the URL location: + +[id]: https://octodex.github.com/images/dojocat.jpg "The Dojocat" + +## Plugins + +The killer feature of `markdown-it` is very effective support of +[syntax plugins](https://www.npmjs.org/browse/keyword/markdown-it-plugin). + +### [Emojies](https://github.com/markdown-it/markdown-it-emoji) + +> Classic markup: :wink: :cry: :laughing: :yum: +> +> Shortcuts (emoticons): :-) :-( 8-) ;) + +see [how to change output](https://github.com/markdown-it/markdown-it-emoji#change-output) with twemoji. + +### [Subscript](https://github.com/markdown-it/markdown-it-sub) / [Superscript](https://github.com/markdown-it/markdown-it-sup) + ++ 19^th^ ++ H~2~O + +### [\](https://github.com/markdown-it/markdown-it-ins) + +++Inserted text++ + +### [\](https://github.com/markdown-it/markdown-it-mark) + +==Marked text== + +### [Footnotes](https://github.com/markdown-it/markdown-it-footnote) + +Footnote 1 link[^first]. + +Footnote 2 link[^second]. + +Inline footnote^[Text of inline footnote] definition. + +Duplicated footnote reference[^second]. + +[^first]: Footnote **can have markup** + + and multiple paragraphs. + +[^second]: Footnote text. + +### [Definition lists](https://github.com/markdown-it/markdown-it-deflist) + +Term 1 + +: Definition 1 +with lazy continuation. + +Term 2 with *inline markup* + +: Definition 2 + + { some code, part of Definition 2 } + + Third paragraph of definition 2. + +*Compact style:* + +Term 1 + ~ Definition 1 + +Term 2 + ~ Definition 2a + ~ Definition 2b + +### [Abbreviations](https://github.com/markdown-it/markdown-it-abbr) + +This is HTML abbreviation example. + +It converts "HTML", but keep intact partial entries like "xxxHTMLyyy" and so on. + +*[HTML]: Hyper Text Markup Language + +### [Custom containers](https://github.com/markdown-it/markdown-it-container) + +::: warning +*here be dragons* +:::