Releases: farazs-github/release-demo
nanoMIPS-2019.03-07-1
nanoMIPS GNU Toolchain v2019.03-07
Published on February 07, 2021
Introduction
The nanoMIPS Toolchain includes example code, source code, and documentation to facilitate development of bare metal applications on nanoMIPS simulators and development boards. These toolchains provide compilers, linkers, libraries and utilities for building applications to run on nanoMIPS cores.
Component Description
- GCC Bare Metal Toolchain
This is a software engineer's cross-development system for nanoMIPS processors, intended for statically linked embedded applications running on bare metal CPUs or light-weight operating systems. - GCC Linux (MUSL) Toolchain
For compiling Linux applications for Linux running on nanoMIPS cores.
Release Notes
This is a re-branding of Wave Computing's previous nanoMIPS GNU toolchain release, v2019.03-06
New Features
- Add support for overlays in GOLD linker.
Bug Fixes
- Fix decoding rule for the SAVE[32] instruction in GDB simulator.
- Enable GDB to correctly single-step over certain nanoMIPS control transfer (BBEQZC, BBNEZC, BEQC[16], BEQC[16], JALRC[16], JRC[16], BRSC) and frame handling (RESTORE.JRC[16], RESTORE.JRC[32], SAVE[32]) instructions.
- Fix misaligned output from assembler when handling jumptable relaxation with table alignment directives. This only affects very large jumptables where 16-bit signed/unsigned offsets are insufficient to cover all the jump vectors.
Other Changes
- Improve link speed for section pattern matching by reducing the number of string operations.
- Treat calls to library functions as absolute regardless if PIC option for bare-metal toolchain. This is trivially predicated on bare-metal links being static.
- Improve scheduling of multi-word loads and stores (LWM/SWM instructions) in the compiler for better performance.
Known issues
- movep optimization produces incorrect code in some cases (FIXME - more details from DraganM). It can still be disabled by using the compiler option -mno-opt-movep or restricted by -mno-movep-follow-copy-chains.
Documentation
FIXME Links to docs by MIPS Tech, needs to be replaced with re-generated MediaTek docs.
- Getting Started Guide, v1.02
- nanoMIPS ABI Supplement, v1.03
- Programmer's Guide, v1.04
- nanoMIPS ABI Porting Guide, v1.02
- Tuning memcpy for MIPS Cores - whitepaper, v0.2
Component Versions
| Component | Based on upstream version |
|---|---|
| binutils | 2.28 |
| GCC | 6.3.0 |
| musl | 1.1.16 |
| newlib | 2.5.0 |
| GDB | 8.0 |
| QEMU | 2.5.0 |
| gold | 2.30 |
| smallClib | Internal |
| Python | 2.7.16 |
Downloads
Prebuilt Binaries
| Variant | Size | Checksum |
|---|---|---|
| Bare Metal Toolchain | ||
| Linux x86 (.tar.gz) | [121M] | 79eadef300d3fc0b98050e684743ee37 d1c0570581afac3d25d767ac3756df86545eef1677446190a5bc8e15c6de613f |
| Windows x86 (.tar.gz) | [91M] | 06295369564c14471081d27ec50d8f43 71b219a34b2a770f54bea05fb71c3310a09f7e9938ad90166fa1c7d5e3c93a00 |
| Linux x64 (.tar.gz) | [118M] | 952481837a9bb5a8dfb002c7c0c64a56 a5a5313bb63b418549e807d38cce068b817f115bf9455ccab6d9975710e3075f |
| Windows 64 (.tar.gz) | [94M] | aa59f5170f1873c3d8002a4eb9c43fb4 6ee4a79dc54c4ee0511edd2d8a0e8ff2c92f08a3302dbcb7a57b941359a26512 |
| MUSL/Linux Toolchain | ||
| Linux x86 (.tar.gz) | [130M] | ba501ac62abf454dc976f3db1e055586 88d7f3534c895a31df547699cdf53c67a593bf0f947750ffb34cdc52360e187c |
| Windows x86 (.tar.gz) | [106M] | 2d4a0f3ed72fb4405cd4f190e89141b5 b771c420edbd506d89a00f78b413a58eced5281f1fc30dff2d0a3b50f5173102 |
| Linux x64 (.tar.gz) | [129M] | 70c835b634478b1dc82e0efa09de9e60 057037ac8a320a0d8b5743d9154846614c3bd669107053597d67f886cc17301a |
| Windows 64 (.tar.gz) | [109M] | 3ebde00dc5ac09a7486a01094c284bfb 2a61b20b8e892668a9c08de319eacf8e9936409d2f32d61f2f0877b0009f59a9 |
Source Components
| Source Package | Size | Checksum |
|---|---|---|
| binutils-2019.03-06-trial-1.src.tar.gz | [51M] | md5: bfe2dba67215a48ae79f7ab13c9f8bde sha256: ec791160c84eaa8a25fedbda83d4221678dc74e8d60c4abd84d87f2773dc8a6f |
| gdb-2019.03-06-trial-1.src.tar.gz | [51M] | md5: deb1c06177f3911ab7b76d5ff4006679 sha256: 715573adfe61a7d2b3bb6ee688c02ec6eff708f6050a111695d82d7c64f97056 |
| gold-2019.03-06-trial-1.src.tar.gz | [52M] | md5: 4936ec3ad183fd1c45c16f177558a0a7 sha256: 09d9738ebaa41f1d4fce8ce597d84cfc2391a4a299e71974cc079db82c4639fb |
| newlib-2019.03-06-trial-1.src.tar.gz | [19M] | md5: aeeea2ef744e792ef0aa308ae2e0ab1f sha256: 9a6af4581be8d3fdaeb40a432f59ed99485ff40a0bcf7bdfe58c6fef0021eadc |
| gcc-2019.03-06-trial-1.src.tar.gz | [112M] | md5: ea69e8fed0bcdaf9598c0fdc676950bb sha256: 12442b4abce26f2d385f54061a71fc56786de97958ed67423c18ebbd231cd813 |
| smallclib-2019.03-06-trial-1.src.tar.gz | [1M] | md5: 7d6705b17da76d6a56e012a272a34ad2 sha256: 9bbb9309c5b428308b3d6fad4cdc35134463b0e7b084b8121a31f5335d94883a |
| qemu-2019.03-06-trial-1.src.tar.gz | [11M] | md5: c42f056ef388530f17e8c5fc933c3601 sha256: 2cfd22441813b163168a8baaaa414a743502bac51d61dbad8a7077eb03dc1255 |
| musl-2019.03-06-trial-1.src.tar.gz | [1M] | md5: 5e5d8d2b574a13bac921c0df7d7b6d96 sha256: abe15d1e27fc306d246b29c6c398859e52c9d333b308b43c07a13e5a75e479ec |
| packages-2019.03-06-trial-1.src.tar.gz | [189M] | md5: 787547bba2667ab42b028aa512d72a42 sha256: ebab8ac045258aa9d2443a44a0ff3b6c510fa6c5f3170cad0ae75047cbebcef9 |
| python-2019.03-06-trial-1.src.tar.gz | [16M] | md5: 9406af6bc6bcd61cbbcd6a8962b605af sha256: 806b40988fb359e837bf020a8996df97b427720b5bdd3620f4fa441721584222 |
License Agreements
License Categories
The components included in this toolchain fall under multiple license agreements:
- GPL v2 - QEMU, Linux
- GPL v3.1 - GNU toolchain, gdb, gmp, mpfr, libiconv
- LGPL v3 - mpc
- MIT / BSD style Licenses - Newlib, smallclib, tinyclib, libgloss/MIPS HAL, musl-libc, libffi, expat, ncurses
- zlib - zlib-libpng license
- PSFL v2 - python
The software included in this product contains copyrighted software that is licensed under the GPLv3. A copy of that license is included in the source. You may obtain the complete Corresponding Source code above.
Licenses for each component are installed as part of the package, are listed in the getting started guide and can be referred to again after the install.
Disclaimer of Warranties and Limitation of Liability
FIXME
License Agreements
GPL v3.1
The source code is distributed under the GNU General Public License version 3,
with the addition under section 7 of an exception described in the "GCC
Runtime Library Exception, version 3.1" as follows (or see the file
COPYING.RUNTIME):
GCC RUNTIME LIBRARY EXCEPTION
Version 3.1, 31 March 2009
Copyright (C) 2009 Free Software Foundation, Inc.
Everyone is permitted to copy and dist...
MediaTek nanoMIPS GNU toolchain v2019.03-07
Published on February 16, 2021
Introduction
The nanoMIPS Toolchain includes example code, source code, and documentation to facilitate development of bare metal applications on nanoMIPS simulators and development boards. These toolchains provide compilers, linkers, libraries and utilities for building applications to run on nanoMIPS cores.
Component Description
- GCC Bare Metal Toolchain
This is a software engineer's cross-development system for nanoMIPS processors, intended for statically linked embedded applications running on bare metal CPUs or light-weight operating systems. - GCC Linux (MUSL) Toolchain
For compiling Linux applications for Linux running on nanoMIPS cores.
Release Notes
New Features
- None.
Bug Fixes
- None.
Other Changes
- Rebrand the release from MIPS to MediaTek.
Known issues
- The movep optimization can lead to bad code generation in some cases. The compiler option -mno-movep-follow-copy-chains can be used to restrict interactions between adjacent optimization sites and avoid this issue.
Documentation
Note These are external links to docunments by MIPS Tech/Wave Computing.
- Getting Started Guide, v1.02
- nanoMIPS ABI Supplement, v1.03
- Programmer's Guide, v1.04
- nanoMIPS ABI Porting Guide, v1.02
- Tuning memcpy for MIPS Cores - whitepaper, v0.2
Component Versions
| Component | Based on upstream version |
|---|---|
| binutils | 2.28 |
| GCC | 6.3.0 |
| musl | 1.1.16 |
| newlib | 2.5.0 |
| GDB | 8.0 |
| QEMU | 2.5.0 |
| gold | 2.30 |
| smallClib | Internal |
| Python | 2.7.16 |
Downloads
Prebuilt Binaries
| Variant | Size | Checksum |
|---|---|---|
| Bare Metal Toolchain | ||
| Linux x86 (.tar.gz) | [116M] | md5: 4fecedf4bec48c63fc5df1f8170300aa sha256: b4606497de686fd37921ce22bea201d160e4edf5461138dd0ac57e0c98342d12 |
| Windows x86 (.tar.gz) | [86M] | md5: 58dc7163a933cded779c4abbea8f5026 sha256: 69bcdf67858dae677871db4a2a9ca0d34148e19e8dbea067bfece95a4d9811a7 |
| Linux x64 (.tar.gz) | [114M] | md5: 7f4a03d642a68a599739b2e471713d9e sha256: 8a8d80ca86cafb6a23429b599306a4241aa92c0b63d4d534188eddf3d05a8200 |
| Windows 64 (.tar.gz) | [89M] | md5: 1ef0133198f1653a3bf074d5db36f5b0 sha256: 87d5ca170e8f855a63cb2beb9dc2a684812d5ea1a005553180d1087b4adbdbae |
| MUSL/Linux Toolchain | ||
| Linux x86 (.tar.gz) | [130M] | md5: 6803ddad4c01dfbd2e2b59c69d21b0a8 sha256: d950d477cb8ec7718a68a28912ee868dc5a24576e3325a324595aff1125489be |
| Windows x86 (.tar.gz) | [106M] | md5: c4887a49eb30bcf7a487a518ffb10dec sha256: ebec8a2f0ba2ccb4678f8299ff0b212241fcbddcd26e7dacc593a0f65c4e96d7 |
| Linux x64 (.tar.gz) | [129M] | md5: 6724f3ddb17760d45be17a30ffdab22f sha256: ba2e4f6afb55ba0101de00ad78f9aee62914897ef858505d9c3b54bb9c44bac7 |
| Windows 64 (.tar.gz) | [109M] | md5: 516db13d0df3fb02489cf8550de51c39 sha256: 36006aff0727f392888467cb2d970a1452e2442324d65cb2de886b5a2a037021 |
Source Components
| Component | Size | Checksum |
|---|---|---|
| binutils-2019.03-07.src.tar.gz | [51M] | md5: 83d6e2ef8ac1b095183ac4c5249e90a5 sha256: 3bee3f7c0cd3419dc4fefba43dc11f15799f1593b85e4dd328e6b8b9eb78fe32 |
| gdb-2019.03-07.src.tar.gz | [51M] | md5: d8478f84bc38eaf9ef575a597781d48c sha256: 565b5a6818aa8627248cec44c35a4d54f097eab4c90a2e97bc5529a1723029b2 |
| gold-2019.03-07.src.tar.gz | [52M] | md5: b5259ec57f0aadfcdb96046a96dcc8f8 sha256: 0df87ee39cb5dbdfd9650388f060c2850cdaffd62794856100aaf9da2537be44 |
| newlib-2019.03-07.src.tar.gz | [19M] | md5: 0a74a8c6fdf5d8eea442581531ccbc49 sha256: 60e453575f6702dbc646129a7dc91885c7e986342dfea598d2fa9ed8f1651d35 |
| gcc-2019.03-07.src.tar.gz | [112M] | md5: bd883c228b4c9883985243cdca8618cd sha256: daacf1c0613cf493a62f29d10e9f935ca7e72282363912e4a4faa4dddc1d8c3e |
| smallclib-2019.03-07.src.tar.gz | [1M] | md5: 08015e0a2cc093008bca43227aa278e0 sha256: 9ef6f164a7bef77d73c09fda04f1fd8fa79bff75eab5662f26805f44234e8f34 |
| qemu-2019.03-07.src.tar.gz | [11M] | md5: d8006374312ecc2aabddc38cdb42642f sha256: 6dc6a14488a7a3e75e59ad34d020eeaf90866f6d9314059df70573e94cc74553 |
| musl-2019.03-07.src.tar.gz | [1M] | md5: 733ca11f83e7e9b80f6ec3c7e26027df sha256: c12d2ac44c62d15739c4e926ed0303667d6f41a89a9ae1b3c078a24ab9b877fb |
| packages-2019.03-07.src.tar.gz | [189M] | md5: 15995cd06863d9b5484bba59e4cf3c02 sha256: 8bea60272f50a0d4308cba4034c245b4a12538a660131b189ef6628597e7d1cd |
| python-2019.03-07.src.tar.gz | [16M] | md5: b40a9b2bfa174e8cc41f9b6e1e5d0f7d sha256: 6e96c6d35108301cfefb26154bf5c5bef43fe97aa2efcf1b84b2befd4f970583 |
License Agreements
License Categories
The components included in this toolchain fall under multiple license agreements:
- GPL v2 - QEMU, Linux
- GPL v3.1 - GNU toolchain, gdb, gmp, mpfr, libiconv
- LGPL v3 - mpc
- MIT / BSD style Licenses - Newlib, smallclib, tinyclib, libgloss/MIPS HAL, musl-libc, libffi, expat, ncurses
- zlib - zlib-libpng license
- PSFL v2 - python
The software included in this product contains copyrighted software that is licensed under the GPLv3. A copy of that license is included in the source. You may obtain the complete Corresponding Source code above.
Licenses for each component are installed as part of the package, are listed in the getting started guide and can be referred to again after the install.
Disclaimer of Warranties and Limitation of Liability
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
TO THE FULLEST EXTENT ALLOWED AND PERMITTED BY APPLICABLE LAWS AND REGULATIONS, MEDIATEK SHALL NOT, UNDER ANY CIRCUMSTANCES, BE LIABLE TO YOU OR ANY THIRD PARTY THROUGH YOU FOR PERSONAL INJURY OR ANY CONSEQUENTIAL, EXEMPLARY, INCIDENTAL, INDIRECT, PUNITIVE OR SPECIAL DAMAGES WHATSOEVER, INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, LOSS OF DATA, BUSINESS INTERRUPTION OR ANY OTHER COMMERCIAL DAMAGES OR LOSSES, ARISING OUT OF OR IN RELATION TO THIS AGREEMENT, YOUR USE OF THE Software Package and DOCUMENTATION, OR YOUR DEVELOPMENT OF APPLICATIONS, WHETHER BASED ON BREACH OF CONTRACT, BREACH OF WARRANTY, TORT (INCLUDING NEGLIGENCE), PRODUCT LIABILITY OR OTHERWISE, EVEN IF MEDIATEK HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
License Agreements
GPL v3.1
The source code is distributed under the GNU General Public License version 3,
with the addition under section 7 of an exception described in the "GCC
Runtime Library Exception, version 3.1" as follows (or see the file
COPYING.RUNTIME):
GCC RUNTIME LIBRARY EXCEPTION
Version 3.1, 31 ...
v2019.03-06-trial-1
Update README.md
MediaTek nanoMIPS GNU toolchain v2019.03-07
Published on February 16, 2021
Introduction
The nanoMIPS Toolchain includes example code, source code, and documentation to facilitate development of bare metal applications on nanoMIPS simulators and development boards. These toolchains provide compilers, linkers, libraries and utilities for building applications to run on nanoMIPS cores.
Component Description
- GCC Bare Metal Toolchain
This is a software engineer's cross-development system for nanoMIPS processors, intended for statically linked embedded applications running on bare metal CPUs or light-weight operating systems. - GCC Linux (MUSL) Toolchain
For compiling Linux applications for Linux running on nanoMIPS cores.
Release Notes
New Features
- None.
Bug Fixes
- None.
Other Changes
- Rebrand the release from MIPS to MediaTek.
Known issues
- The movep optimization can lead to bad code generation in some cases. The compiler option -mno-movep-follow-copy-chains can be used to restrict interactions between adjacent optimization sites and avoid this issue.
Documentation
Note These are external links to docunments by MIPS Tech/Wave Computing.
- Getting Started Guide, v1.02
- nanoMIPS ABI Supplement, v1.03
- Programmer's Guide, v1.04
- nanoMIPS ABI Porting Guide, v1.02
- Tuning memcpy for MIPS Cores - whitepaper, v0.2
Component Versions
| Component | Based on upstream version |
|---|---|
| binutils | 2.28 |
| GCC | 6.3.0 |
| musl | 1.1.16 |
| newlib | 2.5.0 |
| GDB | 8.0 |
| QEMU | 2.5.0 |
| gold | 2.30 |
| smallClib | Internal |
| Python | 2.7.16 |
Downloads
Prebuilt Binaries
| Variant | Size | Checksum |
|---|---|---|
| Bare Metal Toolchain | ||
| Linux x86 (.tar.gz) | [116M] | md5: 4fecedf4bec48c63fc5df1f8170300aa sha256: b4606497de686fd37921ce22bea201d160e4edf5461138dd0ac57e0c98342d12 |
| Windows x86 (.tar.gz) | [86M] | md5: 58dc7163a933cded779c4abbea8f5026 sha256: 69bcdf67858dae677871db4a2a9ca0d34148e19e8dbea067bfece95a4d9811a7 |
| Linux x64 (.tar.gz) | [114M] | md5: 7f4a03d642a68a599739b2e471713d9e sha256: 8a8d80ca86cafb6a23429b599306a4241aa92c0b63d4d534188eddf3d05a8200 |
| Windows 64 (.tar.gz) | [89M] | md5: 1ef0133198f1653a3bf074d5db36f5b0 sha256: 87d5ca170e8f855a63cb2beb9dc2a684812d5ea1a005553180d1087b4adbdbae |
| MUSL/Linux Toolchain | ||
| Linux x86 (.tar.gz) | [130M] | md5: 6803ddad4c01dfbd2e2b59c69d21b0a8 sha256: d950d477cb8ec7718a68a28912ee868dc5a24576e3325a324595aff1125489be |
| Windows x86 (.tar.gz) | [106M] | md5: c4887a49eb30bcf7a487a518ffb10dec sha256: ebec8a2f0ba2ccb4678f8299ff0b212241fcbddcd26e7dacc593a0f65c4e96d7 |
| Linux x64 (.tar.gz) | [129M] | md5: 6724f3ddb17760d45be17a30ffdab22f sha256: ba2e4f6afb55ba0101de00ad78f9aee62914897ef858505d9c3b54bb9c44bac7 |
| Windows 64 (.tar.gz) | [109M] | md5: 516db13d0df3fb02489cf8550de51c39 sha256: 36006aff0727f392888467cb2d970a1452e2442324d65cb2de886b5a2a037021 |
Source Components
| Component | Size | Checksum |
|---|---|---|
| binutils-2019.03-07.src.tar.gz | [51M] | md5: 83d6e2ef8ac1b095183ac4c5249e90a5 sha256: 3bee3f7c0cd3419dc4fefba43dc11f15799f1593b85e4dd328e6b8b9eb78fe32 |
| gdb-2019.03-07.src.tar.gz | [51M] | md5: d8478f84bc38eaf9ef575a597781d48c sha256: 565b5a6818aa8627248cec44c35a4d54f097eab4c90a2e97bc5529a1723029b2 |
| gold-2019.03-07.src.tar.gz | [52M] | md5: b5259ec57f0aadfcdb96046a96dcc8f8 sha256: 0df87ee39cb5dbdfd9650388f060c2850cdaffd62794856100aaf9da2537be44 |
| newlib-2019.03-07.src.tar.gz | [19M] | md5: 0a74a8c6fdf5d8eea442581531ccbc49 sha256: 60e453575f6702dbc646129a7dc91885c7e986342dfea598d2fa9ed8f1651d35 |
| gcc-2019.03-07.src.tar.gz | [112M] | md5: bd883c228b4c9883985243cdca8618cd sha256: daacf1c0613cf493a62f29d10e9f935ca7e72282363912e4a4faa4dddc1d8c3e |
| smallclib-2019.03-07.src.tar.gz | [1M] | md5: 08015e0a2cc093008bca43227aa278e0 sha256: 9ef6f164a7bef77d73c09fda04f1fd8fa79bff75eab5662f26805f44234e8f34 |
| qemu-2019.03-07.src.tar.gz | [11M] | md5: d8006374312ecc2aabddc38cdb42642f sha256: 6dc6a14488a7a3e75e59ad34d020eeaf90866f6d9314059df70573e94cc74553 |
| musl-2019.03-07.src.tar.gz | [1M] | md5: 733ca11f83e7e9b80f6ec3c7e26027df sha256: c12d2ac44c62d15739c4e926ed0303667d6f41a89a9ae1b3c078a24ab9b877fb |
| packages-2019.03-07.src.tar.gz | [189M] | md5: 15995cd06863d9b5484bba59e4cf3c02 sha256: 8bea60272f50a0d4308cba4034c245b4a12538a660131b189ef6628597e7d1cd |
| python-2019.03-07.src.tar.gz | [16M] | md5: b40a9b2bfa174e8cc41f9b6e1e5d0f7d sha256: 6e96c6d35108301cfefb26154bf5c5bef43fe97aa2efcf1b84b2befd4f970583 |
License Agreements
License Categories
The components included in this toolchain fall under multiple license agreements:
- GPL v2 - QEMU, Linux
- GPL v3.1 - GNU toolchain, gdb, gmp, mpfr, libiconv
- LGPL v3 - mpc
- MIT / BSD style Licenses - Newlib, smallclib, tinyclib, libgloss/MIPS HAL, musl-libc, libffi, expat, ncurses
- zlib - zlib-libpng license
- PSFL v2 - python
The software included in this product contains copyrighted software that is licensed under the GPLv3. A copy of that license is included in the source. You may obtain the complete Corresponding Source code above.
Licenses for each component are installed as part of the package, are listed in the getting started guide and can be referred to again after the install.
Disclaimer of Warranties and Limitation of Liability
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
TO THE FULLEST EXTENT ALLOWED AND PERMITTED BY APPLICABLE LAWS AND REGULATIONS, MEDIATEK SHALL NOT, UNDER ANY CIRCUMSTANCES, BE LIABLE TO YOU OR ANY THIRD PARTY THROUGH YOU FOR PERSONAL INJURY OR ANY CONSEQUENTIAL, EXEMPLARY, INCIDENTAL, INDIRECT, PUNITIVE OR SPECIAL DAMAGES WHATSOEVER, INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, LOSS OF DATA, BUSINESS INTERRUPTION OR ANY OTHER COMMERCIAL DAMAGES OR LOSSES, ARISING OUT OF OR IN RELATION TO THIS AGREEMENT, YOUR USE OF THE Software Package and DOCUMENTATION, OR YOUR DEVELOPMENT OF APPLICATIONS, WHETHER BASED ON BREACH OF CONTRACT, BREACH OF WARRANTY, TORT (INCLUDING NEGLIGENCE), PRODUCT LIABILITY OR OTHERWISE, EVEN IF MEDIATEK HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
License Agreements
GPL v3.1
The source code is distributed under the GNU General Public License version 3,
with the addition under section 7 of an exception described in the "GCC
Runtime Library Exception, version 3.1" as follows (or see the fi...
2019.03-06 sample
Download here
<ins>
++Inserted text++
<mark>
==Marked text==
Footnotes
Footnote 1 link1.
Footnote 2 link2.
Inline footnote^[Text of inline footnote] definition.
Duplicated footnote reference2.
Definition lists
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
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
::: warning
here be dragons
:::
2019.03-07 sample release
Advertisement :)
- pica - high quality and fast image
resize in browser. - babelfish - developer friendly
i18n with plurals support and easy syntax.
You will like those projects!
Download here
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
- Marker character change forces new list start:
- Very easy!
Ordered
-
Lorem ipsum dolor sit amet
-
Consectetur adipiscing elit
-
Integer molestie lorem at massa
-
You can use sequential numbers...
-
...or keep all the numbers as
1.
Start numbering with offset:
- foo
- 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
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
Autoconverted link https://github.com/nodeca/pica (enable linkify to see)
Images
Like links, Images also have a footnote style syntax
With a reference later in the document defining the URL location:
Plugins
The killer feature of markdown-it is very effective support of
syntax plugins.
Emojies
Classic markup: 😉 :crush: 😢 :tear: 😆 😋
Shortcuts (emoticons): :-) :-( 8-) ;)
see how to change output with twemoji.
Subscript / Superscript
- 19^th^
- H
2O
<ins>
++Inserted text++
<mark>
==Marked text==
Footnotes
Footnote 1 link1.
Footnote 2 link2.
Inline footnote^[Text of inline footnote] definition.
Duplicated footnote reference2.
Definition lists
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
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
::: warning
here be dragons
:::


