mirror of https://github.com/docsifyjs/docsify.git synced 2025-12-08 19:55:52 +00:00

John Hildenbiddle bf9d7bdcac Dedupe html & fix doc site previews

- Create template for generating multiple `index.html` files (root and `/docs/`)
- Add nunjucks dependency
- Append “(Preview)” to document title for easier identification of local preview tabs/windows (preview only)
- Add custom plugin to fix preview paths to `/docs` resources in markdown (preview only)
- Add front-matter plugin to `/docs/index.html` (missing in previous file, required for front-matter demo in docs)
- Add “build:html” npm script
- Fix preview paths to `/docs` resources in `index.html` files (preview only)
- Remove “Powered by docsify” from footer
- Remove “Vercel has given us a Pro account” from footer (acknowledgement provided via the “Special Thanks” section in README)
- Move “Edit Document” link from top-left to bottom-right of page
- Refactor package.json script (reorder)
- Refactor `.eslintignore` file (reorder and remove duplicate entries)

2020-11-18 14:47:52 -06:00

2.7 KiB

Raw Permalink Blame History

Doc helper

docsify extends Markdown syntax to make your documents more readable.

Note: For the special code syntax cases, you'd better put them within a code backticks to avoid any conflicting from configurations or emojis.

Important content

Important content like:

!> **Time** is money, my friend!

is rendered as:

!> Time is money, my friend!

General tips

General tips like:

?> _TODO_ unit test

are rendered as:

?> TODO unit test

Ignore to compile link

Some time we will put some other relative path to the link, you have to need to tell docsify you don't need to compile this link. For example

[link](/demo/)

It will be compiled to <a href="/#/demo/">link</a> and will be loaded /demo/README.md. Maybe you want to jump to /demo/index.html.

Now you can do that

[link](/demo/ ':ignore')

You will get <a href="/demo/">link</a>html. Do not worry, you can still set title for link.

[link](/demo/ ':ignore title')

<a href="/demo/" title="title">link</a>

Set target attribute for link

[link](/demo ':target=_blank')
[link](/demo2 ':target=_self')

Disable link

[link](/demo ':disabled')

Cross-Origin link

Only when you both set the routerMode: 'history' and externalLinkTarget: '_self', you need add this configuration for those Cross-Origin links.

[example.com](https://example.com/ ':crossorgin')

Github Task Lists

- [ ] foo
- bar
- [x] baz
- [] bam <~ not working
  - [ ] bim
  - [ ] lim

foo
bar
baz
[] bam <~ not working
- bim
- lim

Image

Resizing

![logo](_media/icon.svg ':size=WIDTHxHEIGHT')
![logo](_media/icon.svg ':size=50x100')
![logo](_media/icon.svg ':size=100')

<!-- Support percentage -->

![logo](_media/icon.svg ':size=10%')

Customise class

![logo](_media/icon.svg ':class=someCssClass')

Customise ID

![logo](_media/icon.svg ':id=someCssId')

Customise ID for headings

### Hello, world! :id=hello-world

Markdown in html tag

You need to insert a space between the html and markdown content. This is useful for rendering markdown content in the details element.

<details>
<summary>Self-assessment (Click to expand)</summary>

- Abc
- Abc

</details>

Self-assessment (Click to expand)

Or markdown content can be wrapped in html tag.

<div style='color: red'>

- listitem
- listitem
- listitem

</div>

2.7 KiB Raw Permalink Blame History